AgoraConnectionChangedReason
AgoraConnectionChangedReason
连接状态变化的原因。
枚举值
- 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 加入同一频道为未定义行为，声网不保证所有类似情况都会收到
reason19。 - AgoraConnectionChangedTooManyBroadcasters
- （20）：频道中的主播数量已达上限。
- AgoraConnectionChangedLicenseValidationFailure
- （21）：由于许可证验证失败，连接失败。
- AgoraConnectionChangedCertificationVerifyFailure
- （22）：由于证书验证失败，连接失败。