AgoraConnectionChangedReason Constants Reference

Declared in AgoraEnumerates.h

AgoraConnectionChangedReason

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

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 字节,支持的字符集详见 joinChannelByTokenchannelName 参数描述。请在应用中弹框提示“频道名不合法。请更换有效的频道名并重新加入频道。”

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