RtcConnectionObserver 类

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

OnConnected

Go

OnConnected func(con *RtcConnection, conInfo *RtcConnectionInfo, reason int)

SDK 与频道的连接状态变更为 3 时触发。

参数

参数	描述
con	RTC 连接对象。详见 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 时触发。

参数

参数	描述
con	RTC 连接对象。详见 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。

参数

参数	描述
con	RTC 连接对象。详见 RtcConnection。
token	即将过期的 Token。

OnTokenPrivilegeDidExpire

Go

OnTokenPrivilegeDidExpire func(con *RtcConnection)

Token 已过期回调。

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

参数

参数	描述
con	RTC 连接对象。详见 RtcConnection。

OnUserJoined

Go

OnUserJoined func(con *RtcConnection, uid string)

远端用户加入频道时触发。你可以通过该回调获取远端用户的 ID。

参数

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

OnUserLeft

Go

OnUserLeft func(con *RtcConnection, uid string, reason int)

远端用户离开频道时触发。你可以通过 reason 参数获取用户离开频道的原因。

参数

参数	描述
con	RTC 连接对象。详见 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 方法发送的流消息。

参数

参数	描述
con	RTC 连接对象。详见 RtcConnection。
uid	发送消息的用户 ID。
streamId	接收到的消息的 Stream ID。
errCode	发生错误的错误码。
missed	丢失的消息数量。
cached	数据流中断时，后面缓存的消息数量。

OnError

Go

OnError func(con *RtcConnection, err int, msg string)

发生错误回调。该回调方法表示 SDK 运行时出现了网络或媒体相关的错误。通常情况下，SDK 上报的错误意味着 SDK 无法自动恢复，需要 App 干预或提示用户。

参数

参数	描述
con	RTC 连接对象。详见 RtcConnection。
err	错误码。
msg	错误描述。

OnEncryptionError

Go

OnEncryptionError func(con *RtcConnection, err int);

加密功能发生错误回调。

参数

参数	描述
con	RTC 连接对象。详见 RtcConnection。
err	错误码。