# AgoraClientRoleChangeFailedReason (/zh-CN/api-reference/rtc/ios/enum-clientrolechangefailedreason)

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

<a id="enum_clientrolechangefailedreason__parameters"></a>

## 枚举值 [#枚举值]

<ParameterList>
<a id="agoraclientrolechangefailedtoomanybroadcasters"></a>
<Parameter name="AgoraClientRoleChangeFailedTooManyBroadcasters">

（1）：频道中的主播数量超过限制。

:::note
注： 仅在启用 128 人功能时报告此枚举值。主播的最大数量取决于启用 128 人功能时配置的实际主播数量。
:::

</Parameter>
<a id="agoraclientrolechangefailednotauthorized"></a>
<Parameter name="AgoraClientRoleChangeFailedNotAuthorized">

（2）：请求被声网服务器拒绝。建议提示用户重试切换角色。

</Parameter>
<a id="agoraclientrolechangefailedrequesttimeout"></a>
<Parameter name="AgoraClientRoleChangeFailedRequestTimeout">

（3）：请求超时。建议提示用户检查网络连接并重试切换角色。

</Parameter>
<a id="agoraclientrolechangefailedconnectionfailed"></a>
<Parameter name="AgoraClientRoleChangeFailedConnectionFailed">

（4）：SDK 与声网边缘服务器断开连接。你可以通过 `connectionChangedToState:reason:` 中的 `reason` 排查失败原因。

</Parameter>
</ParameterList>