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