# io.agora.rtc.IRtcConnObserver接口 参考 (/zh-CN/api-reference/rtc-server-sdk/java/interfaceio-1-1agora-1-1rtc-1-1-i-rtc-conn-observer) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). IRtcConnObserver 接口。 ## 成员函数说明 [#成员函数说明] ### onChangeRoleFailure() [#onchangerolefailure] void io.agora.rtc.IRtcConnObserver.onChangeRoleFailure([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*) 本地用户角色切换失败时触发。 一个 AgoraRtcConn 对象。 ### onChangeRoleSuccess() [#onchangerolesuccess] void io.agora.rtc.IRtcConnObserver.onChangeRoleSuccess([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, int *old_role*, int *new_role*) 本地用户角色变更时触发。 一个 AgoraRtcConn 对象。 本地用户变更前的角色: - 1:主播。主播可以同时发送和接收媒体流。 - 2:观众。观众只能接收媒体流。 本地用户变更后的角色: - 1:主播。主播可以同时发送和接收媒体流。 - 2:观众。观众只能接收媒体流。 ### onConnected() [#onconnected] void io.agora.rtc.IRtcConnObserver.onConnected([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcConnInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-info) *conn_info*, int *reason*) SDK 与频道的连接状态变更为 CONNECTION_STATE_CONNECTED(3) 时触发。 一个 AgoraRtcConn 对象。 连接信息。 连接状态变更原因: - 0:建立网络连接中。 - 1:成功加入频道。 - 2:网络连接中断。 - 3:网络连接被服务器禁止。 - 4:无法加入频道超过 20 分钟,停止连接。 - 5:离开频道。 - 6:不是有效的 APP ID,连接失败。 - 7:不是有效的频道名,连接失败。 - 8:生成的 Token 无效,连接失败。 - 9:生成的 Token 过期,连接失败。 - 10:此用户被服务器禁止。 - 11:由于设置了代理服务器,SDK 尝试重连。 - 12:更新 Token 引起网络连接状态改变。 - 13:客户端 IP 地址变更,可能是由于网络类型,或网络运营商的 IP 或端口发生改变引起。 - 14:SDK 和服务器连接保活超时,进入自动重连状态。 - 15:重新加入频道成功。 - 16:SDK 和服务器失去连接。 - 17:连接状态变化由回声测试引起。 - 18:用户更改了本地 IP 地址。 ### onConnecting() [#onconnecting] void io.agora.rtc.IRtcConnObserver.onConnecting([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcConnInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-info) *conn_info*, int *reason*) SDK 与频道的连接状态变更为 CONNECTION_STATE_CONNECTING(2) 时触发。 一个 AgoraRtcConn 对象。 连接信息。 连接状态变更原因。 ### onConnectionFailure() [#onconnectionfailure] void io.agora.rtc.IRtcConnObserver.onConnectionFailure([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcConnInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-info) *conn_info*, int *reason*) SDK 与频道的连接状态变更为 CONNECTION_STATE_FAILED(5) 时触发。 一个 AgoraRtcConn 对象。 连接信息。 连接状态变更原因。 ### onConnectionLost() [#onconnectionlost] void io.agora.rtc.IRtcConnObserver.onConnectionLost([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcConnInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-info) *conn_info*) SDK 失去与频道的连接时触发。 一个 AgoraRtcConn 对象。 连接信息。 ### onDisconnected() [#ondisconnected] void io.agora.rtc.IRtcConnObserver.onDisconnected([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcConnInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-info) *conn_info*, int *reason*) SDK 与频道的连接状态变更为 CONNECTION_STATE_DISCONNECTED(1) 时触发。 一个 AgoraRtcConn 对象。 连接信息。 连接状态变更原因。 ### onEncryptionError() [#onencryptionerror] void io.agora.rtc.IRtcConnObserver.onEncryptionError([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, int *error_type*) 加密出错回调。 一个 AgoraRtcConn 对象。 加密错误类型。 ### onError() [#onerror] void io.agora.rtc.IRtcConnObserver.onError([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, int *error*, String *msg*) 发生错误回调。 该回调方法表示 SDK 运行时出现了网络或媒体相关的错误。通常情况下,SDK 上报的错误意味着 SDK 无法自动恢复,需要 App 干预或提示用户。 一个 AgoraRtcConn 对象。 错误码。 错误描述。 ### onLastmileProbeResult() [#onlastmileproberesult] void io.agora.rtc.IRtcConnObserver.onLastmileProbeResult([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [LastmileProbeResult](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-lastmile-probe-result) *result*) 通话前网络上下行 Last mile 质量探测报告回调。 调用 [startLastmileProbeTest](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#ac79983e9fbfa370c273e9e3c926f7634) 方法 30 秒之后触发该回调。 一个 AgoraRtcConn 对象。 上下行 Last mile 质量探测结果: [LastmileProbeResult](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-lastmile-probe-result)。 ### onLastmileQuality() [#onlastmilequality] void io.agora.rtc.IRtcConnObserver.onLastmileQuality([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, int *quality*) 报告 last-mile 网络质量。 SDK 在调用 [startLastmileProbeTest](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#ac79983e9fbfa370c273e9e3c926f7634) 两秒后触发该回调。 一个 AgoraRtcConn 对象。 Last-mile 网络质量。 - 0:质量未知。 - 1:质量极好。 - 2:用户主观感觉和极好差不多,但码率可能略低于极好。 - 3:用户主观感受有瑕疵但不影响沟通。 - 4:勉强能沟通但不顺畅。 - 5:网络质量非常差,基本不能沟通。 - 6:网络连接断开,完全无法沟通。 ### onNetworkTypeChanged() [#onnetworktypechanged] void io.agora.rtc.IRtcConnObserver.onNetworkTypeChanged([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, int *type*) 本地网络类型发生改变回调。 一个 AgoraRtcConn 对象。 当前网络连接类型: - -1:网络连接类型未知。 - 0:网络连接已断开。 - 1:网络类型为 LAN。 - 2:网络类型为 Wi-Fi(包含热点)。 - 3:网络类型为 2G 移动网络。 - 4:网络类型为 3G 移动网络。 - 5:网络类型为 4G 移动网络。 ### onReconnecting() [#onreconnecting] void io.agora.rtc.IRtcConnObserver.onReconnecting([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcConnInfo](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-conn-info) *conn_info*, int *reason*) SDK 与频道的连接状态变更为 CONNECTION_STATE_RECONNECTING(4) 时触发。 一个 AgoraRtcConn 对象。 连接信息。 连接状态变更原因。 ### onStreamMessageError() [#onstreammessageerror] void io.agora.rtc.IRtcConnObserver.onStreamMessageError([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, String *user_id*, int *stream_id*, int *code*, int *missed*, int *cached*) 接收数据流消息发生错误的回调。该回调表示本地用户未收到远端用户调用 [sendStreamMessage](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#a79f7b350516319c880cba474d98d4844) 方法发送的流消息。 RTC 连接对象。 发送消息的用户 ID。 接收到的消息的 Stream ID。 发生错误的错误码。 丢失的消息数量。 数据流中断时,后面缓存的消息数量。 ### onTokenPrivilegeDidExpire() [#ontokenprivilegedidexpire] void io.agora.rtc.IRtcConnObserver.onTokenPrivilegeDidExpire([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*) Token 已过期时触发。 当收到该回调时,你需要重新在服务端生成新的 Token,然后重新连接频道。 一个 AgoraRtcConn 对象。 ### onTokenPrivilegeWillExpire() [#ontokenprivilegewillexpire] void io.agora.rtc.IRtcConnObserver.onTokenPrivilegeWillExpire([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, String *token*) Token 将在 30s 内过期时触发。 在通话过程中如果 Token 即将失效,SDK 会提前 30 秒触发该回调,提醒 app 更新 Token。 当收到该回调时,你需要重新在服务端生成新的 Token,然后调用 [renewToken](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn#a7a892b8f954dad6d16b730418e84296b) 将新生成的 Token 传给 SDK。 一个 AgoraRtcConn 对象。 将在30 秒内过期的 Token。 ### onTransportStats() [#ontransportstats] void io.agora.rtc.IRtcConnObserver.onTransportStats([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, [RtcStats](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-rtc-stats) *stats*) 报告连接的传输统计信息。 当连接状态为 CONNECTION_STATE_CONNECTED(3) 时,SDK 每两秒触发一次回调。 一个 AgoraRtcConn 对象。 连接统计信息。 ### onUploadLogResult() [#onuploadlogresult] void io.agora.rtc.IRtcConnObserver.onUploadLogResult([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, String *request_id*, int *success*, int *reason*) ### onUserJoined() [#onuserjoined] void io.agora.rtc.IRtcConnObserver.onUserJoined([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, String *user_id*) 远端用户加入频道时触发。 你可以在该回调中获取远端用户 ID。 一个 AgoraRtcConn 对象。 加入频道的远端用户的 ID。 ### onUserLeft() [#onuserleft] void io.agora.rtc.IRtcConnObserver.onUserLeft([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, String *user_id*, int *reason*) 远端用户离开频道时触发。 你可以通过 reason 参数获取该用户离开频道的原因。 一个 AgoraRtcConn 对象。 离开频道的远端用户 ID。 离开频道原因。 ### onUserNetworkQuality() [#onusernetworkquality] void io.agora.rtc.IRtcConnObserver.onUserNetworkQuality([AgoraRtcConn](/zh-CN/api-reference/rtc-server-sdk/java/classio-1-1agora-1-1rtc-1-1-agora-rtc-conn) *agora_rtc_conn*, String *user_id*, int *tx_quality*, int *rx_quality*) 通话中每个用户的网络上下行 last mile 质量报告回调。 该回调每 2 秒触发一次,报告频道内每个用户(包括本地用户)的上下行网络状态。 一个 AgoraRtcConn 对象。 用户 ID。如该参数为空,表示该回调报告的是本地用户的网络质量。 该用户的上行网络质量。 该用户的下行网络质量。 --- 该接口的文档由以下文件生成: - IRtcConnObserver.java