# RtcConnectionObserver 类 (/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnectionobserver.go) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). `RtcConnectionObserver` 类,用于监听 SDK 的连接状态。 ## OnConnected [#onconnected] ```go OnConnected func(con *RtcConnection, conInfo *RtcConnectionInfo, reason int) ``` SDK 与频道的连接状态变更为 `3` 时触发。 #### 参数 [#参数] | 参数 | 描述 | | --- | --- | | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `conInfo` | 连接信息。详见 [`RtcConnectionInfo`](/zh-CN/api-reference/rtc-server-sdk/go-api/apidatatype.go#rtcconninfo)。 | | `reason` | [rtcconnectionobserver-go-html-0-3-1 details](#table-slot-rtcconnectionobserver-go-html-0-3-1) | **rtcconnectionobserver-go-html-0-3-1 details** 连接状态变更原因: - `0`: 建立网络连接中。 - `1`: 成功加入频道。 - `2`: 网络连接中断。 - `3`: 网络连接被服务器禁止。 - `4`: 加入频道失败。 - `5`: 离开频道。 - `6`: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。 - `7`: 不是有效的频道名。请更换有效的频道名重新加入频道。 - `8`: 生成的 Token 无效。一般有以下原因: - 在控制台上启用了 App Certificate,但加入频道未使用 Token。当启用了 App Certificate,必须使用 Token。 - 在调用 [`Connect`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go#connect) 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。 - `9`: 生成的 Token 无效。 - `10`: 此用户被服务器禁止。 - `11`: 由于设置了代理服务器,SDK 尝试重连。 - `12`: 更新 Token 引起网络连接状态改变。 - `13`: 客户端 IP 地址变更,可能是由于网络类型,或网络运营商的 IP 或端口发生改变引起。 - `14`: SDK 和服务器连接保活超时,进入自动重连状态。 - `15`: 重新加入频道成功。 - `16`: SDK 和服务器失去连接。 - `17`: 连接状态变化由回声测试引起。 - `18`: 用户更改了本地 IP 地址。 ## OnDisconnected [#ondisconnected] ```go OnDisconnected func(con *RtcConnection, conInfo *RtcConnectionInfo, reason int) ``` SDK 与频道的连接状态变更为 `1` 时触发。 #### 参数 [#参数-1] | 参数 | 描述 | | --- | --- | | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `conInfo` | 连接信息。详见 [`RtcConnectionInfo`](/zh-CN/api-reference/rtc-server-sdk/go-api/apidatatype.go#rtcconninfo)。 | | `reason` | [rtcconnectionobserver-go-html-1-3-1 details](#table-slot-rtcconnectionobserver-go-html-1-3-1) | **rtcconnectionobserver-go-html-1-3-1 details** 连接状态变更原因: - `0`: 建立网络连接中。 - `1`: 成功加入频道。 - `2`: 网络连接中断。 - `3`: 网络连接被服务器禁止。 - `4`: 加入频道失败。 - `5`: 离开频道。 - `6`: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。 - `7`: 不是有效的频道名。请更换有效的频道名重新加入频道。 - `8`: 生成的 Token 无效。一般有以下原因: - 在控制台上启用了 App Certificate,但加入频道未使用 Token。当启用了 App Certificate,必须使用 Token。 - 在调用 [`Connect`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go#connect) 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。 - `9`: 生成的 Token 无效。 - `10`: 此用户被服务器禁止。 - `11`: 由于设置了代理服务器,SDK 尝试重连。 - `12`: 更新 Token 引起网络连接状态改变。 - `13`: 客户端 IP 地址变更,可能是由于网络类型,或网络运营商的 IP 或端口发生改变引起。 - `14`: SDK 和服务器连接保活超时,进入自动重连状态。 - `15`: 重新加入频道成功。 - `16`: SDK 和服务器失去连接。 - `17`: 连接状态变化由回声测试引起。 - `18`: 用户更改了本地 IP 地址。 ## OnTokenPrivilegeWillExpire [#ontokenprivilegewillexpire] ```go OnTokenPrivilegeWillExpire func(con *RtcConnection, token string) ``` Token 服务将在 30s 内过期回调。 在通话过程中如果 Token 即将失效,SDK 会提前 30 秒触发该回调,提醒 app 更新 Token。 当收到该回调时,你需要重新在服务端生成新的 Token,然后调用 [`RenewToken`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go#renewtoken) 将新生成的 Token 传给 SDK。 #### 参数 [#参数-2] | 参数 | 描述 | |---------------|------------| | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `token` | 即将过期的 Token。 | ## OnTokenPrivilegeDidExpire [#ontokenprivilegedidexpire] ```go OnTokenPrivilegeDidExpire func(con *RtcConnection) ``` Token 已过期回调。 在通话过程中如果 Token 已失效,SDK 会触发该回调,提醒 app 更新 Token。 当收到该回调时,你需要重新在服务端生成新的 Token,然后调用 [`Connect`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go#connect) 重新连接频道。 #### 参数 [#参数-3] | 参数 | 描述 | |---------------|------------| | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | ## OnUserJoined [#onuserjoined] ```go OnUserJoined func(con *RtcConnection, uid string) ``` 远端用户加入频道时触发。你可以通过该回调获取远端用户的 ID。 #### 参数 [#参数-4] | 参数 | 描述 | |---------------|------------| | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `uid` | 远端用户的用户 ID。 | ## OnUserLeft [#onuserleft] ```go OnUserLeft func(con *RtcConnection, uid string, reason int) ``` 远端用户离开频道时触发。你可以通过 `reason` 参数获取用户离开频道的原因。 #### 参数 [#参数-5] | 参数 | 描述 | | --- | --- | | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `uid` | 远端用户的用户 ID。 | | `reason` | [rtcconnectionobserver-go-html-2-3-1 details](#table-slot-rtcconnectionobserver-go-html-2-3-1) | **rtcconnectionobserver-go-html-2-3-1 details** 连接状态变更原因: - `0`: 建立网络连接中。 - `1`: 成功加入频道。 - `2`: 网络连接中断。 - `3`: 网络连接被服务器禁止。 - `4`: 加入频道失败。 - `5`: 离开频道。 - `6`: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。 - `7`: 不是有效的频道名。请更换有效的频道名重新加入频道。 - `8`: 生成的 Token 无效。一般有以下原因: - 在控制台上启用了 App Certificate,但加入频道未使用 Token。当启用了 App Certificate,必须使用 Token。 - 在调用 [`Connect`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go#connect) 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。 - `9`: 生成的 Token 无效。 - `10`: 此用户被服务器禁止。 - `11`: 由于设置了代理服务器,SDK 尝试重连。 - `12`: 更新 Token 引起网络连接状态改变。 - `13`: 客户端 IP 地址变更,可能是由于网络类型,或网络运营商的 IP 或端口发生改变引起。 - `14`: SDK 和服务器连接保活超时,进入自动重连状态。 - `15`: 重新加入频道成功。 - `16`: SDK 和服务器失去连接。 - `17`: 连接状态变化由回声测试引起。 - `18`: 用户更改了本地 IP 地址。 ## OnStreamMessageError [#onstreammessageerror] ```go OnStreamMessageError func(con *RtcConnection, uid string, streamId int, errCode int, missed int, cached int) ``` 接收数据流消息发生错误的回调。该回调表示本地用户未收到远端用户调用 [`send_stream_message`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go#sendstreammessage) 方法发送的流消息。 #### 参数 [#参数-6] | 参数 | 描述 | |-------------|----------| | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `uid` | 发送消息的用户 ID。 | | `streamId` | 接收到的消息的 Stream ID。 | | `errCode` | 发生错误的错误码。 | | `missed` | 丢失的消息数量。 | | `cached` | 数据流中断时,后面缓存的消息数量。 | ## OnError [#onerror] ```go OnError func(con *RtcConnection, err int, msg string) ``` 发生错误回调。该回调方法表示 SDK 运行时出现了网络或媒体相关的错误。通常情况下,SDK 上报的错误意味着 SDK 无法自动恢复,需要 App 干预或提示用户。 #### 参数 [#参数-7] | 参数 | 描述 | |-------------|----------| | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。 | | `err` | 错误码。 | | `msg` | 错误描述。 | ## OnEncryptionError [#onencryptionerror] ```go OnEncryptionError func(con *RtcConnection, err int); ``` 加密功能发生错误回调。 #### 参数 [#参数-8] | 参数 | 描述 | | --- | --- | | `con` | RTC 连接对象。详见 [`RtcConnection`](/zh-CN/api-reference/rtc-server-sdk/go-api/rtcconnection.go)。| | `err` | 错误码。 |