通过阅读本文,您可以了解RTC常见的错误码及对应解决方案。

客户端错误码

十六进制 十进制 错误描述 原因分析 解决方案
0x01030101 16974081 invalid parameter 参数错误,AuthInfo中的字段为空或者timestamp<=0。 检查AuthInfo字段是否完整。
0x01030204 16974340 the operation is rejected in current state 状态错误,SDK内部状态错误。 销毁SDK重新创建实例。
0x01030304 16974596 publish stream is not exist 本地流(视频流、屏幕流、音频流)不存在。 调用publish重新进行推流。
  • 0x01030305
  • 0x01030308
  • 16974597
  • 16974600
publish stream has error 本地流(视频流、屏幕流、音频流)错误。 调用publish重新进行推流。
0x01030403 16974851 subscribe stream is not exist 远端流(视频流、屏幕流、音频流)不存在 。 确认对方是否停止推流。
  • 0x01030404
  • 0x01030405
  • 16974852
  • 16974853
subscribe stream has error 远端流(视频流、屏幕流、音频流)错误 。 确认对方是否停止推流。
  • 0x01010103
  • 0x0101010C
  • 0x0101010D
  • 16843011
  • 16843020
  • 16843021
sdk init error 初始化SDK异常。 检查SDK版本是否正确、JAR包是否缺失。
0x01020204 16908804 join timeout 加入频道超时。 检查网络连接是否正常。
0x0102020C 16908812 signal heartbeat is timeout 心跳包超时。 检查网络连接是否正常。
0x01020401 16909313 signal request is error 信令请求错误。 检查网络连接是否正常。
  • 0x01020210
  • 0x01020211
  • 0x01020212
  • 0x01020213
  • 0x01020214
  • 0x01020215
  • 0x01020216
  • 0x01020217
  • 0x01020218
  • 16908816
  • 16908817
  • 16908818
  • 16908819
  • 16908820
  • 16908821
  • 16908822
  • 16908823
  • 16908824
signal request is timeout 信令请求超时。 检查网络连接是否正常。
0x02010201 33620481 AppId is not exist AppId不存在。 在控制台创建应用。
0x02010202 33620482 AppId is invalid 应用已经停用。 在控制台重新启用应用。
0x02010203 33620483 channel is invalid 加入频道失败:频道已经失效(目前频道有效期为48小时)。 重新生成频道鉴权令牌(Token)。
0x02010205 33620485 token is invalid 加入频道失败:Token无效。 重新生成频道鉴权令牌(Token)。
0x02010401 33620993 publish stream is abort 推流用户推流中断。 调用publish重新进行推流。
0x02010402 33620994 subscribe stream is abort 订阅用户订阅流中断。 确认对方是否停止推流。
0x02010403 33620995 failed to subscribe remote stream 订阅远端流失败:远端流已经停止发布。 无。
0x01040404 17040388 failed to open audio record device or audio device occupied 采集设备初始化失败、采集设备媒体服务异常、音频设备被占用。 Mac端和Windows端查看系统设置中音频设备是否有能量条;iOS端和Android端确认是否被其他应用占用;如果都正常,请重启设备。
0x01040405 17040389 failed to open audio play device or audio device occupied 播放设备初始化失败、播放设备媒体服务异常、音频设备被占用。 Mac端和Windows端查看系统设置中音频设备是否有能量条;iOS端和Android端确认是否被其他应用占用;如果都正常,请重启设备。
0x01040406 17040390 audio recording error or audio device occupied 系统性能不足、采集设备媒体服务异常、音频设备被占用。 重启应用或重启设备。
0x01040407 17040391 audio playing error or audio device occupied 系统性能不足,播放设备媒体服务异常,音频设备被占用。 重启应用或重启设备。
0x01040408 17040392 no audio recording permission 麦克风无权限。 去系统设置中,打开麦克风授权,并且重新加入频道。
0x01040409 17040393 no audio recording device found 麦克风设备异常。 检查是否接入了可用的麦克风,并检查系统设置中,该设备是否被禁用。
0x01040410 17040400 no audio play device found 播放设备异常。 检查是否接入了可用的扬声器或耳机,并检查系统设置中,该设备是否被禁用。
0x01040104 17039620 failed to open camera due to no permission or camera device occupied 相机打开失败、相机设备不可用、相机设备可能被占用。 检查系统相机是否可用,移动端App是否占用了相机。
0x01040106 17039622 camera capturing happens error 相机工作异常:Mac、Winodows电脑相机采集灯熄灭,设备被强制中断。 重新加入频道或者重启App。
0x01040201 17039873 failed to open render device 视频渲染启动失败。 检查Windows端显卡驱动是否需要升级,移动端手机型号或者Android平板盒子等外设是否支持OpenGL。
0x01040202 17039874 render happens error 视频渲染中发生异常:系统异常错误导致渲染引擎报错。 重新加入频道或者重启App。
0x01050201 17105409 failed to create media connection 媒体通道建立失败。 检查网络连接是否正常。
0x01050202 17105410 failed to reconnect media connection 媒体通道重连失败。 检查网络连接是否正常。
0x01060101 17170689 low performance happened 提示性能差。 关掉一些消耗CPU的处理,例如关闭美颜、关闭视频推流等。
0x01060102 17170690 performance restored 提示性能恢复,当前应用运行正常。 无。
0x02010105 33620229 session has been removed Session会话已经被移除。 建议您:销毁实例之后重新创建实例并加入频道。
0x02010121 33620257 H5 is not compatible 客户端不兼容,未正确开启H5兼容模式。 重新检查H5兼容模式是否正确开启。
0x02010903 33622275 failed to join channel due to invalid channel profile 入会失败。 重新检查用户入会模式和其他用户的入会模式(频道模式)是否一致。
0x01010302 16843522 failed to leave channel due to already leaved ERROR_ROOM_LEAVING_NOW,调用离开频道API时,当前用户已经在离会中了。 等离会任务结束后再进行其他操作。
0X01010304 16843524 operation failed dut to not in channel ERROR_ROOM_NOT_IN_THE_CHANNEL,当前用户不在频道中。 请先入会,再执行其他推拉流相关的操作。
  • 0x01010401
  • 0x01010404
  • 16843777
  • 16843780
failed to publish due to already publishing 调用推流API时,当前用户当前已经在推流中了。 不要重复调用Publish,或者先停止推流再调用Publish。
0x01010402 16843778 operation failed dut to not in publishing ERROR_PUBLISH_NOT_PUBLISHER,调用停止推流API时,当前用户并没有在推流。 不要重复调用停止推流的API。
0x01010405 16843781 publish config is invalid ERROR_PUBLISH_CONFIG_IS_INVALID,Publish的配置错误。 检查Publish的配置信息。
0x01010501 16844033 subscribe config is invalid ERROR_SUBSCRIBE_CONFIG_IS_INVALID,Subscribe的配置错误。 检查Subscribe的配置信息。
0x01020110 16908560 failed to update role SOPHON_RESULT_UPDATE_ROLE_ERROR,更新角色失败。 请确认当前的channelProfile(频道类型),如果是Communication(通信)模式,无需设置ClientRole(角色类型)。更新角色需要在停止推流的时候。
  • 0x01020201
  • 0x01020202
  • 0x01020203
  • 0x01020205
  • 0x01020206
  • 0x01020207
  • 0x01020208
  • 0x01020209
  • 0x0102020A
  • 0x0102020B
  • 0x0102020D
  • 0x0102020E
  • 0x0102020F
  • 0x01020219
  • 0x01020220
  • 0x01020221
  • 0x01020222
  • 16908801
  • 16908802
  • 16908803
  • 16908805
  • 16908806
  • 16908807
  • 16908808
  • 16908809
  • 16908810
  • 16908811
  • 16908813
  • 16908814
  • 16908815
  • 16908825
  • 16908832
  • 16908833
  • 16908834
signal request is timeout 信令请求超时。 检查网络连接是否正常。
0x00000101 257 network weak SDK_WARNING_NETWORK_WEAK,网络质量较差。 检查网络连接是否正常。
0x00000102 258 network recovered SDK_WARNING_NETWORK_RECOVERY,网络质量恢复。 无。
0x00000103 259 network disconnected SDK_WARNING_LOCAL_NETWORK_DISCONNECT,本地网络连接断开。 检查网络连接是否正常。
0x00000104 260 remote network disconnected SDK_WARNING_REMOTE_NETWORK_DISCONNECT,远端用户网络连接断开。 无。
0x00000105 261 local network connected SDK_WARNING_LOCAL_NETWORK_CONNECT,本地网络连接恢复。 无。
0x00000106 262 remote network connected SDK_WARNING_REMOTE_NETWORK_CONNECT,远端用户网络连接恢复。 无。
0x01070101 17236225 external audio input buffer is full SDK_AUDIO_INPUT_BUFFER_FULL,外部音频输入时,频次过快导致缓冲饱和。 降低外部输入频次。建议设置等待20ms,并且单次不超过40ms数据。
0x0103030d 16974605 failed to publish due to wrong role SDK_RESULT_PUBLISH_WRONG_ROLE_ERROR,观众角色不能推流。 检查当前用户角色。
0x01090003 17367043 failed to open media file 打开文件失败。 请检查文件路径是否正确,文件是否具有可读权限。
0xFFFFFFFF -1 WARN_DEFAULT 默认告警信息。 无。
0x02010101 33620225 session subscribe 客户端订阅对方时失败,可能原因:对方未推流或者停止推流。 确保对方推流期间调用订阅接口。

加入频道错误码

十六进制 十进制 错误描述 原因分析 解决方案
0x01010301 16843521 already joine 用户已经加入房间。 检查接口调用逻辑。
0x02010903 33622275 failed to join channel due to invalid channel profile channel profile不匹配,如第一个人以通讯模式入会,之后如果有人已互动模式入会就会报此错。 重新检查用户入会模式和其他用户的入会模式(频道模式)是否一致。
0x05040002 84148226 channel is overdue
  • 用户欠费了。
  • 用户的Token过期了,可以通过timestamp参数判断。
  • appid,appkey不对,或者不对应,一个appid对应唯一的一个appkey。
  • 用户的鉴权参数错误。
排查以下情况:
  • 确认账户余额是否充足。
  • 确认Token是否过期,可以通过timestamp参数判断,转成北京时间。第一种情况本身就是过期时间,第二种是本身+48小时是过期时间。
  • AppId和AppKey不匹配,一个AppId对应唯一的AppKey。
  • 确认鉴权参数是否正确。
0x02010702 33621762 join channel failed due to same user repeat join,please check if another device still in the channel 用户重复入会失败。如同一个用户,两个设备,进入同一个会。或者该用户上一个session还没有退会完成。 检查接口调用逻辑。
0x02010104 33620228 session join 客户端离开频道了之后又使用了相同的sessionId入会。 请尝试重新加入频道。
0x02010204 33620484 channel is not exist 加入频道失败,频道不存在。如会议发起者入会后又很快离会,第二个人随后入会,发现会议已经不存在了。 请尝试重新加入频道。
0x05010011 83951633 join channel failed due to invaild channel id gslb请求ChannelId无效。如ChannelId不能带有空格。 检查channelId(频道ID)格式。

频道ID支持1~64位,大小写字母、数字、下划线(_)、中划线(-)。

0x05010012 83951634 join channel failed due to invaild user id gslb请求UserId无效。 请尝试重新加入频道。
0x0501001a 83951642 join channel due to invaild channel id AppId配置了大方会模式,需要使用1.16.5以上的包入会,否则会入会失败。 检查SDK版本。
0x01020201 16908801 signal request is timeout gslb请求长时间未收到,导致响应超时。 检查网络连接是否正常。
0x01020204 16908804 join timeout 入会请求长时间未收到,导致响应超时。 检查网络连接是否正常。
0x01030202 16974338 join error 加入房间错误。 检查鉴权信息是否正确以及网络环境是否正常。
0x01030201 16974337 gslb error 参数AuthInfo中的gslb字段错误。 检查AuthInfo中gslb字段是否完整,或验证AuthInfo是否可以通过校验。

旁路直播错误码

十六进制 十进制 错误描述 原因分析 解决方案
0x01100001 17825793 mpu task not found MPU任务没有传入URL或停止已经停止的任务。 检查更新、停止MPU任务时传入的URL,或是否停止已经停止的任务。
0x01100002 17825794 mpu task already exist 启动已经启动的MPU任务。 检查是否在启动已经启动的MPU任务。
0x01100003 17825795 mpu task invalid param 传入无效的参数。 检查传入的参数是否合理或在有效范围内。
0x01100004 17825796 mpu task internal error SDK内部错误,包括但不限于网络错误、服务端错误等。 尝试重新发起请求。
0x01100005 17825797 mpu task rtmp server error 服务端RTMP服务始化失败或资源下载失败。 检查MPU任务中资源链接的有效性(务必处理)。
0x01100006 17825798 mpu task rtmp stream error 服务端RTMP流错误。 检查RTMP流的URL格式是否正确有效(务必处理)。
0x01100007 17825799 mpu task publish timeout 服务端推流超时。 尝试重新发起请求(务必处理)。

跨频道推流错误码

十六进制 十进制 错误描述 原因分析 解决方案
0x01200001 18874369 channel relay state error 没有入会、角色错误或频道模式错误。 检查入会状态,确保当前为互动模式和主播角色。
0x01200002 18874370 channel relay src not allow 跨频道推流时频道模式错误。 切换频道模式为互动模式或低延迟互动直播模式。
0x01200003 18874371 channel relay join dest failed 跨频道推流时目标频道不存在或目标频道和源频道不是同一种频道模式。 检查跨频道时目标频道是否存在,确保目标频道和源频道模式一致(例如,都为互动模式)。
0x01200005 18874373 channel relay role error 跨频道推流的角色错误。 切换角色为主播角色。
0x01200006 18874374 channel realy invalid param 传入的参数不合法。 检查传入的参数是否合理或在有效范围内。
0x01200007 18874375 channel realy to self error 目标频道号和源频道号一致。 输入正确的目标频道号,不能和源频道号相同。

跨频道拉流错误码

十六进制 十进制 错误描述 原因分析 解决方案
0x01300001 19922945 channel relay sub request error 请求中的参数包含非法字符或格式。 检查请求参数格式的正确性和合法性。
0x01300002 19922946 channel relay sub request timeout 跨频道拉流请求超时。 尝试重新发送请求。
0x01300003 19922947 channel relay sub server timeout 没有在规定时间内创建目标频道,导致超时。 确保目标频道已经创建,尝试重新发送请求。