# AgoraConnectionChangedReason (/zh-CN/api-reference/rtc/macos/enum-connectionchangedreasontype)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="enum_connectionchangedreasontype__parameters"></a>

## 枚举值 [#枚举值]

<ParameterList>
<a id="agoraconnectionchangedreasonconnecting"></a>
<Parameter name="AgoraConnectionChangedReasonConnecting">

（0）：SDK 正在连接声网边缘服务器。

</Parameter>
<a id="agoraconnectionchangedreasonjoinsuccess"></a>
<Parameter name="AgoraConnectionChangedReasonJoinSuccess">

（1）：SDK 成功加入频道。

</Parameter>
<a id="agoraconnectionchangedreasoninterrupted"></a>
<Parameter name="AgoraConnectionChangedReasonInterrupted">

（2）：SDK 与声网边缘服务器的连接中断。

</Parameter>
<a id="agoraconnectionchangedreasonbannedbyserver"></a>
<Parameter name="AgoraConnectionChangedReasonBannedByServer">

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

</Parameter>
<a id="agoraconnectionchangedreasonjoinfailed"></a>
<Parameter name="AgoraConnectionChangedReasonJoinFailed">

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

</Parameter>
<a id="agoraconnectionchangedreasonleavechannel"></a>
<Parameter name="AgoraConnectionChangedReasonLeaveChannel">

（5）：SDK 已离开频道。

</Parameter>
<a id="agoraconnectionchangedreasoninvalidappid"></a>
<Parameter name="AgoraConnectionChangedReasonInvalidAppId">

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

</Parameter>
<a id="agoraconnectionchangedreasoninvalidchannelname"></a>
<Parameter name="AgoraConnectionChangedReasonInvalidChannelName">

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

</Parameter>
<a id="agoraconnectionchangedreasoninvalidtoken"></a>
<Parameter name="AgoraConnectionChangedReasonInvalidToken">

（8）：Token 无效。可能原因包括：项目在声网控制台启用了 App Certificate，但加入频道时未传入 Token；调用 [joinChannelByToken\:channelId\:uid\:mediaOptions\:joinSuccess:](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_joinchannel2) 时指定的 uid 与生成 Token 时使用的 uid 不一致；生成的 Token 与用于加入频道的 Token 不一致。请确保：启用 App Certificate 的项目加入频道时必须传入 Token；生成 Token 时指定的用户 ID 与加入频道时使用的用户 ID 一致；生成的 Token 与用于加入频道的 Token 一致。

</Parameter>
<a id="agoraconnectionchangedreasontokenexpired"></a>
<Parameter name="AgoraConnectionChangedReasonTokenExpired">

（9）：当前使用的 Token 已过期。请在服务器上生成新的 Token，并使用该 Token 重新加入频道。

</Parameter>
<a id="agoraconnectionchangedreasonrejectedbyserver"></a>
<Parameter name="AgoraConnectionChangedReasonRejectedByServer">

（10）：连接被服务器拒绝。可能原因包括：用户已在频道中，但仍调用 [joinChannelByToken\:channelId\:uid\:mediaOptions\:joinSuccess:](/zh-CN/api-reference/rtc/macos/channel#api_irtcengine_joinchannel2) 加入频道；或用户正在进行通话测试时尝试加入频道。请停止调用该方法或在通话测试结束后再加入频道。

</Parameter>
<a id="agoraconnectionchangedreasonsettingproxyserver"></a>
<Parameter name="AgoraConnectionChangedReasonSettingProxyServer">

（11）：由于 SDK 设置了代理服务器，连接状态变为重连中。

</Parameter>
<a id="agoraconnectionchangedreasonrenewtoken"></a>
<Parameter name="AgoraConnectionChangedReasonRenewToken">

（12）：由于更新 Token，连接状态发生变化。

</Parameter>
<a id="agoraconnectionchangedreasonclientipaddresschanged"></a>
<Parameter name="AgoraConnectionChangedReasonClientIpAddressChanged">

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

</Parameter>
<a id="agoraconnectionchangedreasonkeepalivetimeout"></a>
<Parameter name="AgoraConnectionChangedReasonKeepAliveTimeout">

（14）：SDK 与声网边缘服务器之间的连接保活超时，SDK 会自动尝试重连。

</Parameter>
<a id="agoraconnectionchangedreasonrejoinsuccess"></a>
<Parameter name="AgoraConnectionChangedReasonRejoinSuccess">

（15）：用户已成功重新加入频道。

</Parameter>
<a id="agoraconnectionchangedreasonlost"></a>
<Parameter name="AgoraConnectionChangedReasonLost">

（16）：SDK 与服务器之间的连接已丢失。

</Parameter>
<a id="agoraconnectionchangedreasonechotest"></a>
<Parameter name="AgoraConnectionChangedReasonEchoTest">

（17）：由于回声测试，连接状态发生变化。

</Parameter>
<a id="agoraconnectionchangedclientipaddresschangedbyuser"></a>
<Parameter name="AgoraConnectionChangedClientIpAddressChangedByUser">

（18）：本地 IP 地址被用户更改。

</Parameter>
<a id="agoraconnectionchangedsameuidlogin"></a>
<Parameter name="AgoraConnectionChangedSameUidLogin">

（19）：用户在不同设备上以相同 UID 加入同一频道。

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

</Parameter>
<a id="agoraconnectionchangedtoomanybroadcasters"></a>
<Parameter name="AgoraConnectionChangedTooManyBroadcasters">

（20）：频道中的主播数量已达上限。

</Parameter>
<a id="agoraconnectionchangedlicensevalidationfailure"></a>
<Parameter name="AgoraConnectionChangedLicenseValidationFailure">

（21）：由于许可证验证失败，连接失败。

</Parameter>
<a id="agoraconnectionchangedcertificationverifyfailure"></a>
<Parameter name="AgoraConnectionChangedCertificationVerifyFailure">

（22）：由于证书验证失败，连接失败。

</Parameter>
</ParameterList>