AgoraConnectionChangedReason

  • macOS

更新时间不可用

连接状态变化的原因。

枚举值

参数名描述
AgoraConnectionChangedReasonConnecting

(0):SDK 正在连接声网边缘服务器。

AgoraConnectionChangedReasonJoinSuccess

(1):SDK 成功加入频道。

AgoraConnectionChangedReasonInterrupted

(2):SDK 与声网边缘服务器的连接中断。

AgoraConnectionChangedReasonBannedByServer

(3):SDK 与声网边缘服务器的连接被服务器禁止。例如,用户被踢出频道时会返回该状态。

AgoraConnectionChangedReasonJoinFailed

(4):SDK 加入频道失败。若超过 20 分钟仍未加入成功,将返回该状态并停止重连。请提示用户切换网络后重新加入频道。

AgoraConnectionChangedReasonLeaveChannel

(5):SDK 已离开频道。

AgoraConnectionChangedReasonInvalidAppId

(6):App ID 无效。请使用有效的 App ID 重新加入频道,并确保该 App ID 与声网控制台中生成的一致。

AgoraConnectionChangedReasonInvalidChannelName

(7):频道名无效。请使用有效的频道名重新加入频道。频道名为不超过 64 字节的字符串,支持的字符共 89 个,包括:小写字母 a-z、大写字母 A-Z、数字 0-9,以及以下符号:!、#、$、% 、&、(、)、+、-、:、;、<、=、.、>、?、@、[、]、^、_、{、}、|、~、,。

AgoraConnectionChangedReasonInvalidToken

(8):Token 无效。可能原因包括:项目在声网控制台启用了 App Certificate,但加入频道时未传入 Token;调用 joinChannelByToken:channelId:uid:mediaOptions:joinSuccess: 时指定的 uid 与生成 Token 时使用的 uid 不一致;生成的 Token 与用于加入频道的 Token 不一致。请确保:启用 App Certificate 的项目加入频道时必须传入 Token;生成 Token 时指定的用户 ID 与加入频道时使用的用户 ID 一致;生成的 Token 与用于加入频道的 Token 一致。

AgoraConnectionChangedReasonTokenExpired

(9):当前使用的 Token 已过期。请在服务器上生成新的 Token,并使用该 Token 重新加入频道。

AgoraConnectionChangedReasonRejectedByServer

(10):连接被服务器拒绝。可能原因包括:用户已在频道中,但仍调用 joinChannelByToken:channelId:uid:mediaOptions:joinSuccess: 加入频道;或用户正在进行通话测试时尝试加入频道。请停止调用该方法或在通话测试结束后再加入频道。

AgoraConnectionChangedReasonSettingProxyServer

(11):由于 SDK 设置了代理服务器,连接状态变为重连中。

AgoraConnectionChangedReasonRenewToken

(12):由于更新 Token,连接状态发生变化。

AgoraConnectionChangedReasonClientIpAddressChanged

(13):客户端 IP 地址发生变化。若多次收到该状态码,请提示用户切换网络并重新加入频道。

AgoraConnectionChangedReasonKeepAliveTimeout

(14):SDK 与声网边缘服务器之间的连接保活超时,SDK 会自动尝试重连。

AgoraConnectionChangedReasonRejoinSuccess

(15):用户已成功重新加入频道。

AgoraConnectionChangedReasonLost

(16):SDK 与服务器之间的连接已丢失。

AgoraConnectionChangedReasonEchoTest

(17):由于回声测试,连接状态发生变化。

AgoraConnectionChangedClientIpAddressChangedByUser

(18):本地 IP 地址被用户更改。

AgoraConnectionChangedSameUidLogin

(19):用户在不同设备上以相同 UID 加入同一频道。

注: 使用相同 UID 加入同一频道为未定义行为,声网不保证所有类似情况都会收到 reason 19。

AgoraConnectionChangedTooManyBroadcasters

(20):频道中的主播数量已达上限。

AgoraConnectionChangedLicenseValidationFailure

(21):由于许可证验证失败,连接失败。

AgoraConnectionChangedCertificationVerifyFailure

(22):由于证书验证失败,连接失败。

表格内容超出当前宽度,可横向滚动查看更多列。

这个页面有帮助吗?