需要访问旧版文档站？前往旧版文档官网首页。 (在新标签页打开)
声网文档中心

RtcConnectionObserver 类

  • Go

更新时间不可用

RtcConnectionObserver 类，用于监听 SDK 的连接状态。

OnConnected

Go
OnConnected func(con *RtcConnection, conInfo *RtcConnectionInfo, reason int)
SDK 与频道的连接状态变更为 3 时触发。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
conInfo连接信息。详见 RtcConnectionInfo。
reason

连接状态变更原因：

  • 0: 建立网络连接中。
  • 1: 成功加入频道。
  • 2: 网络连接中断。
  • 3: 网络连接被服务器禁止。
  • 4: 加入频道失败。
  • 5: 离开频道。
  • 6: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。
  • 7: 不是有效的频道名。请更换有效的频道名重新加入频道。
  • 8: 生成的 Token 无效。一般有以下原因：
    • 在控制台上启用了 App Certificate，但加入频道未使用 Token。当启用了 App Certificate，必须使用 Token。
    • 在调用 Connect 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。
  • 9: 生成的 Token 无效。
  • 10: 此用户被服务器禁止。
  • 11: 由于设置了代理服务器，SDK 尝试重连。
  • 12: 更新 Token 引起网络连接状态改变。
  • 13: 客户端 IP 地址变更，可能是由于网络类型，或网络运营商的 IP 或端口发生改变引起。
  • 14: SDK 和服务器连接保活超时，进入自动重连状态。
  • 15: 重新加入频道成功。
  • 16: SDK 和服务器失去连接。
  • 17: 连接状态变化由回声测试引起。
  • 18: 用户更改了本地 IP 地址。
表格内容超出当前宽度，可横向滚动查看更多列。

OnDisconnected

Go
OnDisconnected func(con *RtcConnection, conInfo *RtcConnectionInfo, reason int)
SDK 与频道的连接状态变更为 1 时触发。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
conInfo连接信息。详见 RtcConnectionInfo。
reason

连接状态变更原因：

  • 0: 建立网络连接中。
  • 1: 成功加入频道。
  • 2: 网络连接中断。
  • 3: 网络连接被服务器禁止。
  • 4: 加入频道失败。
  • 5: 离开频道。
  • 6: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。
  • 7: 不是有效的频道名。请更换有效的频道名重新加入频道。
  • 8: 生成的 Token 无效。一般有以下原因：
    • 在控制台上启用了 App Certificate，但加入频道未使用 Token。当启用了 App Certificate，必须使用 Token。
    • 在调用 Connect 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。
  • 9: 生成的 Token 无效。
  • 10: 此用户被服务器禁止。
  • 11: 由于设置了代理服务器，SDK 尝试重连。
  • 12: 更新 Token 引起网络连接状态改变。
  • 13: 客户端 IP 地址变更，可能是由于网络类型，或网络运营商的 IP 或端口发生改变引起。
  • 14: SDK 和服务器连接保活超时，进入自动重连状态。
  • 15: 重新加入频道成功。
  • 16: SDK 和服务器失去连接。
  • 17: 连接状态变化由回声测试引起。
  • 18: 用户更改了本地 IP 地址。
表格内容超出当前宽度，可横向滚动查看更多列。

OnTokenPrivilegeWillExpire

Go
OnTokenPrivilegeWillExpire func(con *RtcConnection, token string)
Token 服务将在 30s 内过期回调。

在通话过程中如果 Token 即将失效，SDK 会提前 30 秒触发该回调，提醒 app 更新 Token。 当收到该回调时，你需要重新在服务端生成新的 Token，然后调用 RenewToken 将新生成的 Token 传给 SDK。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
token即将过期的 Token。
表格内容超出当前宽度，可横向滚动查看更多列。

OnTokenPrivilegeDidExpire

Go
OnTokenPrivilegeDidExpire func(con *RtcConnection)
Token 已过期回调。

在通话过程中如果 Token 已失效，SDK 会触发该回调，提醒 app 更新 Token。 当收到该回调时，你需要重新在服务端生成新的 Token，然后调用 Connect 重新连接频道。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
表格内容超出当前宽度，可横向滚动查看更多列。

OnUserJoined

Go
OnUserJoined func(con *RtcConnection, uid string)
远端用户加入频道时触发。你可以通过该回调获取远端用户的 ID。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
uid远端用户的用户 ID。
表格内容超出当前宽度，可横向滚动查看更多列。

OnUserLeft

Go
OnUserLeft func(con *RtcConnection, uid string, reason int)
远端用户离开频道时触发。你可以通过 reason 参数获取用户离开频道的原因。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
uid远端用户的用户 ID。
reason

连接状态变更原因：

  • 0: 建立网络连接中。
  • 1: 成功加入频道。
  • 2: 网络连接中断。
  • 3: 网络连接被服务器禁止。
  • 4: 加入频道失败。
  • 5: 离开频道。
  • 6: 不是有效的 APP ID。请更换有效的 APP ID 重新加入频道。
  • 7: 不是有效的频道名。请更换有效的频道名重新加入频道。
  • 8: 生成的 Token 无效。一般有以下原因：
    • 在控制台上启用了 App Certificate，但加入频道未使用 Token。当启用了 App Certificate，必须使用 Token。
    • 在调用 Connect 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。
  • 9: 生成的 Token 无效。
  • 10: 此用户被服务器禁止。
  • 11: 由于设置了代理服务器，SDK 尝试重连。
  • 12: 更新 Token 引起网络连接状态改变。
  • 13: 客户端 IP 地址变更，可能是由于网络类型，或网络运营商的 IP 或端口发生改变引起。
  • 14: SDK 和服务器连接保活超时，进入自动重连状态。
  • 15: 重新加入频道成功。
  • 16: SDK 和服务器失去连接。
  • 17: 连接状态变化由回声测试引起。
  • 18: 用户更改了本地 IP 地址。
表格内容超出当前宽度，可横向滚动查看更多列。

OnStreamMessageError

Go
OnStreamMessageError func(con *RtcConnection, uid string, streamId int, errCode int, missed int, cached int)
接收数据流消息发生错误的回调。该回调表示本地用户未收到远端用户调用 send_stream_message 方法发送的流消息。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
uid发送消息的用户 ID。
streamId接收到的消息的 Stream ID。
errCode发生错误的错误码。
missed丢失的消息数量。
cached数据流中断时，后面缓存的消息数量。
表格内容超出当前宽度，可横向滚动查看更多列。

OnError

Go
OnError func(con *RtcConnection, err int, msg string)
发生错误回调。该回调方法表示 SDK 运行时出现了网络或媒体相关的错误。通常情况下，SDK 上报的错误意味着 SDK 无法自动恢复，需要 App 干预或提示用户。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
err错误码。
msg错误描述。
表格内容超出当前宽度，可横向滚动查看更多列。

OnEncryptionError

Go
OnEncryptionError func(con *RtcConnection, err int);

加密功能发生错误回调。

参数

参数描述
conRTC 连接对象。详见 RtcConnection。
err错误码。
表格内容超出当前宽度，可横向滚动查看更多列。

咨询电话

400 632 6626

上海声网科技有限公司

Copyright © 2026 声网保留所有权利