文档中心
极速直播 (Legacy)
Console 官网 社区 技术支持
简体中文
search-icon
文档中心  >  极速直播 (Legacy)  >  API 参考  >  Windows API Reference (C#)  >  错误码和警告码
错误码和警告码
Updated Time 2023/06/15 07:16

错误码和警告码

在调用声网 API 过程中，SDK 可能会返回错误码和警告码。其中错误码意味着 SDK 遭遇了不可恢复的错误，需要 app 干预；警告码意味着 SDK 遇到问题，但有可能恢复。警告码仅起告知作用，一般情况下 app 可以忽略警告码。

无论是何种情况，你都可以参考本文，了解这些错误码和警告码的详细含义，及其解决方法。对于未给出解决方法的错误码，声网推荐你提交工单，我们的技术服务会根据你在实际场景中遇到的问题进行排查。

SDK 在返回错误码时，可能会返回一个负数。这个负数就对应着错误码或警告码里的正整数。例如返回 -2，则对应错误码或警告码里的 2。

声网 SDK 在运行过程中，可能通过如下方式返回错误码或警告码：

  • 在方法调用失败的返回值中，返回一个负数，这个负数就对应着错误码与警告码里的正数。

  • 通过 OnError 或者 OnWarning 回调报告错误码或警告码。

基础错误码

枚举值说明
0没有错误。
1一般性的错误（没有明确归类的错误原因）。请重新调用方法。
2方法中设置了无效的参数。例如指定的频道名中含有非法字符。请重新设置参数。
3SDK 尚未准备好。可能的原因有：
  • IAgoraRtcEngine 初始化失败。请重新初始化 IAgoraRtcEngine。
  • 调用方法时用户尚未加入频道。请检查方法的调用逻辑。
  • 调用 Rate 或 Complain 方法时用户尚未离开频道。请检查方法的调用逻辑。
  • 请检查是否已开启音频模块。
  • 请检查程序集完整性。
4IAgoraRtcEngine 当前状态不支持该操作。可能的原因有：
  • Android 平台调用 SetBeautyEffectOptions 方法时，如果设备版本低于 Android 4.4，会报这个错。请确认 Android 设备版本。
  • 使用内置加密时，设置的加密模式不正确，或加载外部加密库失败。请检查加密的枚举值是否正确，或重新加载外部加密库。
5方法调用被拒绝。可能的原因有：
  • IAgoraRtcEngine 初始化失败。请重新初始化 IAgoraRtcEngine。
  • 在创建 IAgoraRtcChannel 对象时，将频道名设为空字符 ""。请重新设置频道名。
  • 多频道场景下，在调用 JoinChannel [2/2] 方法加入频道时，设置的频道名已存在。请重新设置频道名。
  • 已经通过 IAgoraRtcChannel 加入了一个频道，并在该频道中发布了音视频流，又尝试通过 IAgoraRtcEngine 的 joinChannel 方法加入第二个频道。如果已经通过 IAgoraRtcChannel 对象加入了一个频道，且在该频道内发了流，就不能再通过 IAgoraRtcEngine 的 joinChannel 方法加入第二个频道。
  • 在调用 SwitchChannel [2/2] 方法切换直播频道时，用户角色不是观众。调用 switchChannel 方法时，请确保当前的用户角色为观众。
6缓冲区大小不足以存放返回的数据。
7尚未初始化 IAgoraRtcEngine 就调用方法。请确认在调用该方法前已创建 IAgoraRtcEngine 对象，并完成初始化。
9没有操作权限。请检查用户是否授予了 app 音视频设备的使用权限。
10方法调用超时。有些方法调用需要 SDK 返回结果，如果 SDK 处理事件过长，超过 10 秒没有返回，会出现此错误。
17加入频道被拒绝。一般有以下原因：
  • 用户已经在频道中，再次调用加入频道的方法，如 JoinChannel [2/2] 时，会返回此错误。停止调用该方法即可。
  • 用户在调用 StartEchoTest [2/3] 进行通话测试时，未结束当前测试就尝试加入频道。开始通话测试后，需要先调用 StopEchoTest 结束当前测试，再加入频道。
18离开频道失败。一般有以下原因：
  • 用户已离开频道，再次调用退出频道的方法，如 LeaveChannel 时，会返回此错误。停止调用该方法即可。
  • 用户尚未加入频道，就调用退出频道的方法。这种情况下无需额外操作。
19资源已被占用，不能重复使用。
20SDK 放弃请求，可能由于请求的次数太多。
21Windows 下特定的防火墙设置导致 IAgoraRtcEngine 初始化失败然后崩溃。
22当 app 占用资源过多或系统资源耗尽时，SDK 分配资源失败，会返回该错误。
101不是有效的 App ID。请更换有效的 App ID 重新加入频道。
102不是有效的频道名。可能的原因是设置的参数数据类型不正确。请更换有效的频道名重新加入频道。
103无法获取当前区域的服务器资源。请在初始化 IAgoraRtcEngine 时尝试指定其他区域。
109弃用：从 v2.4.1 起废弃。请改用 OnConnectionStateChanged 回调中的 CONNECTION_CHANGED_TOKEN_EXPIRED(9)。当前使用的 Token 过期，不再有效。请在服务端申请生成新的 Token，并调用 RenewToken 更新 Token。
110弃用：从 v2.4.1 起废弃。请改用 OnConnectionStateChanged 回调中的 CONNECTION_CHANGED_INVALID_TOKEN(8)。Token 无效。一般有以下原因：
  • 在声网控制台中启用了 App 证书，但仍旧在代码里使用了 App ID。当项目启用了 App 证书，就必须使用 Token 鉴权。
  • 生成 Token 时填入的用户 ID 和用户加入频道时填入的用户 ID 不匹配。
111网络连接中断。SDK 在和服务器建立连接后，失去了网络连接超过 4 秒，会报告该错误。
112网络连接丢失。 网络连接中断，且 SDK 无法在 10 秒内连接服务器，会报告fail错误。
113调用方法时用户不在频道内。
114在调用 SendStreamMessage 时，当发送的数据长度大于 1024 个字节时，会返回该错误。
115在调用 SendStreamMessage 时，当发送数据的频率超过限制（6 KB/s）时，会返回该错误。
116在调用 CreateDataStream [2/2] 时，如果创建的数据通道过多（超过 5 个）时，会返回该错误。
117数据流发送超时。
119用户切换角色失败。
120解密失败。可能是用户加入频道时使用了错误的密码。请检查用户加入频道时填入的密码，或引导用户尝试重新加入频道。
123此用户被服务器禁止。当用户被服务端踢出时会报这个错。
134无效的用户 user account，可能是因为设置了无效的参数。

水印相关错误码

枚举值说明
124水印文件参数错误。
125水印文件路径错误。
126水印图片文件格式错误。SDK 只支持添加 PNG 格式的水印图片。
127水印文件信息错误。
128水印文件数据格式错误。
129水印文件读取错误。

推流相关错误码

枚举值说明
130如果开启了媒体流加密，则在调用 AddPublishStreamUrl 时，会返回该错误。SDK 不支持将加密过的流推到 CDN 上。
151推流到 CDN 报错。请调用 RemovePublishStreamUrl 删除当前的推流地址，然后调用 AddPublishStreamUrl 重新尝试推流。
152单个主播的推流地址数目达到上限 10。请删掉一些不用的推流地址，再增加新的推流地址。
153主播操作不属于自己的流，如更新其他主播的流的参数，或停止其他主播的流。请检查 app 逻辑。
154推流服务器出现错误。请调用 AddPublishStreamUrl 重新推流。
155服务器无法找到数据流。
156推流地址格式有错误。请检查推流地址格式是否正确。

音频相关错误码

枚举值说明
1005音频设备出现错误（未指明何种错误）。请检查音频设备是否被其他应用占用，或者尝试重新进入频道。
1006使用 Java 资源出错。请确认设备内存是否够用，或重启设备。
1007设置的采样频率出现错误。
1008初始化播放设备出错。请检查播放设备是否被其他应用占用，或者尝试重新进入频道。
1009启动播放设备出错。请检查播放设备是否正常，或者尝试重新进入频道。
1010停止播放设备出错。
1011初始化录音设备出错。请检查录音设备是否正常，或者尝试重新进入频道。
1012启动录音设备出错。请检查录音设备是否正常，或者尝试重新进入频道。
1013停止录音设备出错。
1015播放出错。请检查播放设备是否正常，或者尝试重新进入频道。
1017录音错误。请检查音频采集设备是否正常，或者尝试重新进入频道。
1018录音失败。
1022初始化 Loopback 设备错误。
1023启动 Loopback 设备错误。
1027没有录音权限。请检查是否已经打开录音权限，或者录音设备是否被第三方应用占用。
1033录音设备被占用。
1101使用 Java 资源出现错误。请确认设备内存是否够用，或重启设备。
1108采集频率低于 50，常见为 0，即录音未启动，建议检查录音权限。
1109播放频率低于 50，常见为 0，即播放未启动，建议检查是否 AudioTrack 实例过多。
1111录音启动失败，系统 ROM 报错，建议重启 app 或重启手机、检查录音权限。
1112播放启动失败，系统 ROM 报错，建议重启 app 或重启手机、检查播放权限。
1115录音失败。请确认设备权限或网络连接状况。
1201当前设备不支持音频输入，可能的原因是 Audio Session 的 category 配置不对或音频输入设备被占用。建议终止后台所有应用的进程，重新加入频道。
1206Audio Session 启动失败。请检查你的音频采集设置。
1210初始化音频设备出错。一般出错是因为音频设备的设置参数错误。
1213重新初始化音频设备出错。一般出错是因为音频设备的设置参数错误。
1214重新启动音频设备出错。一般出错是因为 Audio Session 的 category 设置与音频设备的设置不兼容。
1301音频设备模块初始化失败。请禁用并重新启用音频设备，或者重启机器。
1303音频设备模块终止失败。请禁用并重新启用音频设备，或者重启机器。
1306播放设备初始化失败。请禁用并重新启用音频设备，或者重启机器。
1307无音频播放设备，导致初始化失败。请插入音频设备。
1309启动录音失败。请禁用并重新启用音频设备，或者重启机器。
1311创建录音线程失败，可能的原因是内存或设备性能不足。请重启机器或者更换机器。
1314启动录音失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1319创建播放线程失败，可能的原因是内存或设备性能不足。请重启机器或者更换机器。
1320启动播放失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1322无可用音频采集设备。请连接可用的录音设备。
1323无可用音频播放设备。请连接可用的播放设备。
1351音频设备模块初始化失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1353初始化录音设备失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1354初始化麦克风失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1355初始化播放设备失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1356初始化扬声器失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1357启动录音失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1358启动播放失败。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1359无录音设备。请检查是否有可用的录音设备或者录音设备是否已经被其他应用占用。
1360无播放设备。请检查是否有可用的播放设备或者播放设备是否已经被其他应用占用。
1735Windows Audio 服务被关闭。你需要开启 Windows Audio 服务或重启设备。

视频相关错误码

枚举值说明
1003弃用：从 v2.4.1 起废弃。请改用 OnLocalVideoStateChanged 回调中的 LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4)。启动摄像头失败。请检查摄像头是否被其他应用占用，或者尝试重新加入频道。
1004启用视频渲染模块失败。
1510没有摄像头使用权限。请检查是否已经打开摄像头权限。
1512弃用：v2.4.1 起废弃。请改用 OnLocalVideoStateChanged 回调中的 LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3)。摄像头正在使用中。
1600未知错误。
1601视频编码初始化失败。请尝试重新加入频道。
1602视频编码失败。请尝试重新加入频道。
1603视频编码参数设置失败。
1736SDK 不支持你在多显卡的 Windows 设备上设置 excludeWindowList 屏蔽窗口。

其他错误码

枚举值说明
1001加载媒体引擎失败。
1002启动媒体引擎后开始通话失败。请尝试重新进入频道。

警告码

枚举值说明
8指定的 View 无效，使用视频功能时需要指定 View，如果 View 尚未指定，则返回该警告。
16初始化视频功能失败。有可能是视频资源被占用导致的。用户无法看到视频画面，但不影响语音通信。
20请求处于待定状态。一般是由于某个模块还没准备好，请求被延迟处理。
103没有可用的频道资源。可能是因为服务器没法分配频道资源。
104查找频道超时。在加入频道时 SDK 先要查找指定的频道，出现该警告一般是因为网络太差，无法连接服务器。
105弃用：从 v2.4.1 起废弃。请改用 OnConnectionStateChanged 回调中的 CONNECTION_CHANGED_REJECTED_BY_SERVER(10)。查找频道请求被服务器拒绝。服务器可能没有办法处理这个请求或请求是非法的。
106加入频道超时。查找到指定频道后，SDK 接着加入该频道，超时一般是因为网络太差，连接不到服务器。
107加入频道请求被服务器拒绝。服务器可能没有办法处理该请求或该请求是非法的。
111切换直播视频超时。
118直播场景下设置用户角色超时。
121TICKET 非法，加入频道失败。
122尝试连接另一个服务器。
131频道连接不可恢复。
132IP 已改变。
133端口已改变。
701打开伴奏文件出错。
1014运行时播放设备出现警告。
1016运行时录音设备出现警告。
1019采集无声音。请确认麦克风是否被占用，录音权限是否给予，采集设备是否正常工作，或者重启设备。
1020播放频率异常。该异常原因为系统 CPU 占用率高，建议关闭其他可能占用 CPU 的应用。还可以检查 app 是否关闭了音频模块，或尝试重新加入频道。
1021采集频率异常，该异常原因为系统 CPU 占用率高，建议关闭其他可能占用 CPU 的应用。还可以检查 app 是否关闭了音频模块，或尝试重新加入频道。
1025播放或录制音频时被系统事件（如来电）干扰。
1029在通话过程中，Audio Session 的 category 必须设置成 AVAudioSessionCategoryPlayAndRecord，IAgoraRtcEngine 会监控这个属性值。当这个值被修改成其他值的时候会触发这个告警，并强制设置回 AVAudioSessionCategoryPlayAndRecord。
1031采集的音量过小。请确认麦克风是否静音，或者麦克风增强是否打开。
1032播放的音量过小。请确认对端用户麦克风是否静音，或者其麦克风增强是否打开。
1033采集设备被占用。请确认音频采集设备的使用权限，或采集设备是否被第三方应用占用。
1040无音频。禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1051录制音频时监测到啸叫。请检查两个客户端的距离是否足够远。
1052系统采集和播放音频线程无法完成调度，通常是由于系统 CPU 占用率高。
1053检测到残余回声，该回声可能由系统线程调度不及时或信号溢出导致。
1323无可用音频播放设备。请插入音频设备。
1324音频采集释放有误。请禁用并重新启用音频设备，或者重启机器，或者更新声卡驱动。
1610远端用户的原始视频流的分辨率超出了可以应用超分辨率算法的要求。
1611已指定一个远端用户使用超分辨率算法。
1612当前设备不支持超分算法。