AgoraConnectionChangedReason Constants Reference

Declared in AgoraEnumerates.h

AgoraConnectionChangedReason

引起网络连接状态发生改变的原因

Definition

typedef NS_ENUM(NSUInteger, AgoraConnectionChangedReason ) {
   AgoraConnectionChangedConnecting = 0,
   AgoraConnectionChangedJoinSuccess = 1,
   AgoraConnectionChangedInterrupted = 2,
   AgoraConnectionChangedBannedByServer = 3,
   AgoraConnectionChangedJoinFailed = 4,
   AgoraConnectionChangedLeaveChannel = 5,
   AgoraConnectionChangedInvalidAppId = 6,
   AgoraConnectionChangedInvalidChannelName = 7,
   AgoraConnectionChangedInvalidToken = 8,
   AgoraConnectionChangedTokenExpired = 9,
   AgoraConnectionChangedRejectedByServer = 10,
   AgoraConnectionChangedSettingProxyServer = 11,
   AgoraConnectionChangedRenewToken = 12,
   AgoraConnectionChangedClientIpAddressChanged = 13,
   AgoraConnectionChangedKeepAliveTimeout = 14,
   AgoraConnectionChangedSameUidLogin = 19,
   AgoraConnectionChangedTooManyBroadcasters = 20,
};

Constants

AgoraConnectionChangedConnecting

0: 建立网络连接中。

Declared In AgoraEnumerates.h.

AgoraConnectionChangedJoinSuccess

1: 成功加入频道。

Declared In AgoraEnumerates.h.

AgoraConnectionChangedInterrupted

2: 网络连接中断。

Declared In AgoraEnumerates.h.

AgoraConnectionChangedBannedByServer

3: 网络连接被服务器禁止。可能是由于服务端调用封禁用户权限 API 将用户踢出频道。请在应用中弹框提示“用户被踢出频道”。

Declared In AgoraEnumerates.h.

AgoraConnectionChangedJoinFailed

4: 加入频道失败。当 SDK 收到 connectionChangedToState(AgoraConnectionStateReconnecting, AgoraConnectionChangedInterrupted) 后连续 20 分钟无法重新加入频道时，会报告该状态并停止重连。请在应用中弹框显示“因网络问题无法加入频道。请尝试切换网络并重新加入频道。”

Declared In AgoraEnumerates.h.

AgoraConnectionChangedLeaveChannel

5: 离开频道。

Declared In AgoraEnumerates.h.

AgoraConnectionChangedInvalidAppId

6: 不是有效的 APP ID。请检查用户使用的 App ID 是否与从声网控制台获取的项目的 App ID 一致，并更换有效的 APP ID 重新加入频道。

Declared In AgoraEnumerates.h.

AgoraConnectionChangedInvalidChannelName

7: 不是有效的频道名。频道名不能为空，且字符长度不能超过 64 字节，支持的字符集详见 joinChannelByToken 的 channelName 参数描述。请在应用中弹框提示“频道名不合法。请更换有效的频道名并重新加入频道。”

Declared In AgoraEnumerates.h.

AgoraConnectionChangedInvalidToken

8: 生成的 Token 无效。一般有以下原因：

  • 在控制台上启用了 App Certificate，但加入频道未使用 Token。当启用了 App Certificate，必须使用 Token。
  • 在调用 joinChannelByToken 加入频道时指定的 uid 与生成 Token 时传入的 uid 不一致。
    • 请检查用户使用的 Token 是否与业务服务器上生成的 Token 一致，并更换有效的 Token 重新加入频道。

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedTokenExpired

    9: 当前使用的 Token 过期，用户被迫退出频道。客户端需要重新向自己的业务服务器申请 Token，并使用新的 Token 重新加入频道。

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedRejectedByServer

    10: 此用户被服务器禁止。一般有以下原因：

  • 用户已进入频道，再次调用加入频道的 API，例如 joinChannelByToken，会返回此状态。停止调用该方法即可。
  • 用户在调用 startEchoTestWithInterval 进行通话测试时尝试加入频道。等待通话测试结束后再加入频道即可。

    • Declared In AgoraEnumerates.h.

    AgoraConnectionChangedSettingProxyServer

    11: 由于设置了代理服务器，SDK 尝试重连。

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedRenewToken

    12: 更新 Token 引起网络连接状态改变。

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedClientIpAddressChanged

    13: 由于网络类型，或网络运营商的 IP 或端口发生改变，客户端 IP 地址变更，SDK 尝试重连。如果多次出现该状态，请在应用中弹框提示“您的网络连接不稳定，建议切换网络。”

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedKeepAliveTimeout

    14: SDK 和服务器连接保活超时，进入自动重连状态 AgoraConnectionStateReconnecting(4).

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedSameUidLogin

    19: 使用相同的 UID 从不同的设备加入同一频道。

    Available in v3.7.0

    Declared In AgoraEnumerates.h.

    AgoraConnectionChangedTooManyBroadcasters

    20: 频道内主播人数已达上限。

    Available in v3.7.0

    Declared In AgoraEnumerates.h.

    Declared In

    AgoraEnumerates.h