本文为您介绍了客户端常见错误码。通过查询对应的错误码,您可以快速定位客户端出现的错误,方便您更好的体验音视频通信相关服务。

十六进制 十进制 错误描述 描述 建议您
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包是否缺失。
0x1020204 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)。
0x02010204 33620484 channel is not exist 加入频道失败:频道不存在。 重新加入频道。
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。
0x0104020 1064992 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兼容模式是否正确开启。
0x05040002 84148226 channel is overdue 房间过期,需要重新进入房间。 排查以下情况:
  • 确认账户余额是否充足。
  • 确认Token是否过期,可以通过timestamp参数判断,转成北京时间。第一种情况本身就是过期时间,第二种是本身+48小时是过期时间。
  • AppId和AppKey不匹配,一个AppId对应唯一的AppKey。
  • 确认鉴权参数是否正确。
0x02010903 33622275 failed to join channel due to invalid channel profile 入会失败。 重新检查用户入会模式和其他用户的入会模式(频道模式)是否一致。
0x01010301 16843521 failed to join channel due to already in channel ERROR_ROOM_ALREADY_IN,加入频道时,当前用户已经在频道中。 调用leaveChannel离开频道,再重新调用joinChannel加入频道。
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 默认告警信息 -
0x00002905 10501 ERROR_H5_COMPATIBLE_MODE 配置错误,H5兼容模式错误 在非H5端开启H5兼容模式。