错误码
更新时间: 2023/01/13 10:39:44
在调用 Web SDK API 的过程中,SDK 可能会返回错误码或状态码,您可以根据错误码或状态码判断当前 SDK 或任务的状态。如果遇到未知的错误码,请联系技术支持排查。
V4.6.25 之前版本的错误码
错误码 | 说明 |
---|---|
INVALID_PARAMETER = 41000 | 参数无效。 请通过 console 日志查看错误原因及处理方式。 |
NOT_SUPPORT = 41001 | 浏览器不支持。 请通过 console 日志查看错误原因及处理方式。 |
NO_SERVER_ADDRESS = 41002 | 未找到服务器地址。 请联系网易云信技术支持。 |
SOCKET_ERROR = 41003 | 服务器地址连接失败。 请联系网易云信技术支持。 |
NO_SIGNALLING = 41004 | 未找到信令。 请联系网易云信技术支持。 |
NO_STATS = 41005 | 数据格式错误。 请联系网易云信技术支持。 |
NO_MEDIASERVER = 41006 | 未找到媒体服务。 请联系网易云信技术支持。 |
NO_MEETINGS = 41007 | 未找到会议信息。请联系网易云信技术支持。 |
NO_LOCALSTREAM = 41008 | 未找到 localStream 数据。 请通过 console 日志查看错误原因及处理方式。 |
INVALID_OPERATION = 41009 | 接口调用错误。 请通过 console 日志查看错误原因及处理方式。 |
REPEAT_JOIN = 41010 | 重复加入房间。 |
USER_NOT_IN_CHANNEL = 41011 | 本地用户不在频道中。 请通过 console 日志查看错误原因及处理方式。 |
NOT_SUPPORTED_YET = 41012 | 当前浏览器不支持的操作。 |
UNKNOWN_TYPE = 41013 | 参数类型错误。 请通过 console 日志查看错误原因及处理方式。 |
NOT_ALLOWED = 41014 | 权限错误。 请通过 console 日志查看错误原因及处理方式。 |
STATE_ERROR = 41015 | 状态错误。 请联系网易云信技术支持。 |
NO_FILE = 41016 | 未找到文件。 请通过 console 日志查看错误原因及处理方式。 |
DECODE_FAILED = 41017 | 解码失败。 请通过 console 日志查看错误原因及处理方式。 |
ADD_TASK_FAILED = 41018 | 添加推流任务失败。 请通过 console 日志查看错误原因及处理方式。 |
DELETE_TASK_FAILED = 41019 | 删除推流任务失败。 请通过 console 日志查看错误原因及处理方式。 |
UPDATE_TASKS_FAILED = 41020 | 更新推流任务失败。 请通过 console 日志查看错误原因及处理方式。 |
RECORD_API_ERROR = 41021 | 录制接口调用错误。 请通过 console 日志查看错误原因及处理方式。 |
NO_RECORDER_FOUND = 41022 | 未开始录制。 请通过 console 日志查看错误原因及处理方式。 |
NOT_DEFINED = 41023 | 未定义的错误。 请通过 console 日志查看错误原因及处理方式。 |
NOT_AVALIABLE = 41024 | 不可用的错误。 请通过 console 日志查看错误原因及处理方式。 |
NO_MEDIAHELPER = 41025 | 媒体数据错误。 请通过 console 日志查看错误原因及处理方式,或联系网易云信技术支持。 |
NO_PLAY = 41026 | 未开启播放。 请通过 console 日志查看错误原因及处理方式,或联系网易云信技术支持。 |
NO_RECORD = 41027 | 未开启录制。 请通过 console 日志查看错误原因及处理方式。 |
NOT_FOUND = 41028 | 参数设置错误。 请通过 console 日志查看错误原因及处理方式。 |
APPDATA_ERROR = 41029 | 媒体数据错误。 请通过 console 日志查看错误原因及处理方式,或联系网易云信技术支持。 |
AUTO_PLAY_NOT_ALLOWED = 41030 | 浏览器自动播放受限。 请通过 console 日志查看错误原因及处理方式,或者参考 浏览器自动播放受限处理。 |
MEDIA_OPEN_BANNED_BY_SERVER = 41032 | 音视频被服务器禁言。 请通过 console 日志查看错误原因及处理方式。 |
PROXY_SERVER_ERROR = 41033 | 云代理开启失败。 请通过 console 日志查看错误原因及处理方式,或联系网易云信技术支持。 |
UNKNOWN = 99999 | 未知原因错误。 请联系网易云信技术支持。 |
V4.6.25 版本的错误码
均可请通过 console 日志查看错误原因及处理方式。
错误码 | 说明 |
---|---|
INVALID_PARAMETER_ERROR = 10000 | 参数无效。 |
NOT_SUPPORT_ERROR = 10001 | 浏览器不支持。 |
NETWORK_ERROR = 10002 | 网络环境异常。 |
NETWORK_REQUEST_ERROR = 10003 | 网络请求异常。 |
SERVER_ERROR = 10004 | 云信服务异常。 |
MEDIA_SERVER_ERROR = 10005 | 云信媒体服务异常。 |
SIGNALLING_ERROR = 10006 | 云信信令异常。 |
SIGNALLING_SERVER_ERROR = 10007 | 云信信令服务异常。 |
API_CALL_SEQUENCE_ERROR = 10008 | 接口调用顺序异常。 |
INVALID_OPERATION_ERROR = 10009 | 操作异常。 |
LOCALSTREAM_ERROR = 10010 | localStream 异常。 |
LOCALSTREAM_NOT_FOUND_ERROR = 10011 | localStream 未找到。 |
UNKNOWN_TYPE_ERROR = 10012 | 未知类型异常。 |
UNDEFINED_ERROR = 10013 | 未定义异常。 |
UNAVAILABLE_ERROR = 10014 | 不可用异常。 |
BANNED_BY_SERVER = 10015 | 被服务器禁言。 |
SOCKET_INIT_ERROR = 10016 | socket 异常。 |
REPEAT_JOIN_ERROR = 10101 | 重复加入房间。 |
MEETING_ERROR = 10102 | 会控异常。 |
ROOM_SERVER_ERROR = 10103 | 房间服务相关错误。 |
USER_NOT_IN_CHANNEL_ERROR = 10104 | 用户不在频道中。 |
EVENT_UPLOAD_ERROR = 10105 | 事件上报错误。 |
NOT_FOUND_ERROR = 10106 | 未找到异常。 |
SDP_ERROR = 10107 | SDP 异常。 |
ADD_TASK_FAILED_ERROR = 10201 | 添加推流任务失败。 |
DELETE_TASK_FAILED_ERROR = 10202 | 删除推流任务失败。 |
UPDATE_TASKS_FAILED_ERROR = 10203 | 更新推流任务失败。 |
TASK_ERROR = 10204 | 推流任务异常。 |
PLAY_NOT_START_ERROR = 10205 | 未开始播放异常。 |
APPDATA_OVERRIDE_ERROR = 10206 | appData 异常。 |
SET_BEAUTY_ERROR = 10401 | 开关基础美颜相关异常。 |
SET_ADVANCED_BEAUTY_ERROR = 10402 | 开关高级美颜相关异常。 |
SET_BODY_SEGMENT_ERROR = 10403 | 开关虚拟背景相关异常。 |
FORMAT_AUDIO_ERROR = 10420 | 音频处理异常。 |
AUDIO_MIX_FILE_ERROR = 10421 | 伴音相关操作状态异常。 |
AUDIO_EFFECT_STATE_ERROR = 10423 | 音效相关操作状态异常。 |
AUDIO_EFFECT_FILE_LOST_ERROR = 10424 | 音效文件缺失。 |
AUDIO_MIX_DECODE_FAILED_ERROR = 10425 | 伴音解码异常。 |
AUDIO_MIXING_ERROR = 10426 | 伴音相关异常。 |
AUDIO_EFFECT_ERROR = 10426 | 音效相关异常。 |
SET_ENCRYPTION_MODE_ERROR = 10440 | 国密加密相关异常。 |
PROXY_ERROR = 10441 | 云代理相关异常。 |
RECORDING_ERROR = 10450 | 录制参数异常。 |
RECORDING_NOT_START_ERROR = 10451 | 录制未开始异常。 |
WATERMARKS_EXCEEDED_ERROR = 10460 | 水印数量超出限制。 |
LBS_REQUEST_ERROR = 10461 | LBS 请求相关异常。 |
LBS_JSON_ERROR = 10462 | LBS json 解析异常。 |
NO_STATS_ERROR = 10470 | LBS 请求相关异常。 |
AUTO_PLAY_NOT_ALLOWED = 41030 | 自动播放受限异常,相关解决办法请参考浏览器自动播放受限处理。 |
UNKNOWN = 99999 | 未知错误。 |
V4.6.40 及之后版本的错误码
100XX 通用错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10000 | 通用参数错误 | 参数缺失、格式错误等。 | 请根据 RtcError 对象中的 message 信息判断具体错误的参数,也可以通过 console 日志查看错误原因及处理方式。 |
10001 | 系统环境不支持云信 SDK 运行。 | 调用 createClient 、createStream 或 getDevices 接口时,浏览器版本过低、浏览器不支持或没有使用 https 环境。 |
请前往开发文档查阅云信 SDK 支持的系统浏览器环境,也可以通过 console 日志查看错误原因及处理方式。 |
10002 | 网络环境异常,导致云信服务器连接彻底失败。 | 用户网络问题,比如防火墙限制、网络连接不成功或云信服务器异常。 | 请先检查个人网络,可以尝试切换网络;若确认网络没有问题,请稍后重试或联系云信技术支持。 |
10003 | http 请求发生错误。 | 用户网络问题,比如防火墙限制、网络连接不成功或云信服务器异常,具体原因可以查看 RtcError 对象中的 message 信息。 |
请先检查个人网络,可以尝试切换网络;若确认网络没有问题,请稍后重试或联系云信技术支持。join 、addTasks 或 deleteTasks |
10008 | 非法操作。 | 接口使用姿势有误。 | 请根据 RtcError 对象中的 message 信息判断具体原因,也可以通过 console 日志查看错误原因及处理方式。 |
10009 | 接口调用顺序有误。 | 该接口需要在 join 之前调用,但是当前已加入房间。 |
请在 join 之前调用当前接口。 |
10010 | 接口调用顺序有误。 | 该接口需要在 join 之后调用,但是当前尚未加入房间或 join 调用失败。 |
请在成功调用 join 之后调用当前接口。 |
10011 | 本地流 localStream 异常。 | 该 localStream 对象已经被销毁、该 localStream 对象不是通过 NERTC.createSteam() 创建的或者重复使用了多个 localStream 对象,但是没有管理好多实例对象的应用。 |
请根据分析出的错误原因做出相应的措施。 |
10012 | SDK 系统内部错误。 | 请根据 RtcError 对象中的 message 信息判断具体原因,也可以通过 console 日志查看错误原因及处理方式。 |
请联系云信技术支持,并提供具体信息。 |
10020 | 当前正在网络重连中。 | 当前 SDK 内部正在重连,相关接口调用会失败,并反馈此错误。 | 请联系云信技术支持,并提供具体信息。 |
10099 | 服务端错误。 | 请根据 RtcError 对象中的 message 信息判断具体原因,也可以通过 console 日志查看错误原因及处理方式。 |
请联系云信技术支持,并提供具体信息。 |
101XX 房间相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10100 | SDK 内部错误,导致加入房间失败。 | 系统内部异常。 | 请联系云信技术支持,并提供具体信息。 |
10101 | 重复加入房间。 | 在已在房间内的情况下重复调用 join 。 |
建议在业务层规避此行为,也可以忽略此报错,因为 SDK 会主动忽略 join 的第二次调用。 |
10104 | 用户不在房间中。 | 当前该 client 尚未加入房间、加入房间失败或者已经离开房间。 | 建议在业务层规避此种行为,在加入房间成功后再调用相应接口。 |
10109 | 服务器 permKey 权限控制不允许该用户加入房间。 | - | 可以通过您业务服务器自行调整 permKey 的规则。 |
10110 | 参数错误,调用 join 方法时没有传递 channelName 参数。 |
- | 调用 join 方法时传递合法的 channelName 参数即可。 |
10111 | 参数错误,调用 join 方法时传递的 recordAudio 或 recordVideo 参数不是 Boolean 类型。 |
- | 请保证 recordAudio 或 recordVideo 参数设置正确。 |
10112 | 参数错误,调用 join 方法时传递的 uid 参数有误,uid 仅支持 string 和 number 两种类型的格式。 |
uid 非 string 或 number 类型,或者 uid 是 number 类型,但是值超过了 number 类型的最大值(2^53 - 1)。 |
请保证 uid 的数据类型正确;若需要使用较大值,请使用 string 格式。 |
10119 |
服务端认证返回的错误。 |
App Key、Token 等信息错误。 |
请根据
|
10121 | 参数有误,调用 setChannelProfile 方法时传递的参数有误,option 需要为 mode ,其中 mode 必须为 rtc 或 live 。 |
option 不是 rtc 或 live 。 |
请保证 option 参数设置正确。 |
10131 | 用户角色错误。 | 当前用户为观众角色,不允许调用 addTasks 方法。 |
建议在业务层规避此种行为,应该在调用 setClientRole 方法将用户角色切换为主播(host)后,再调用上述方法。 |
10132 | 参数有误,调用 addTasks 方法时参数传递有误。 |
rtmpTasks 参数为空,或者该数组的长度为空。 |
请保证 rtmpTasks 参数设置正确。 |
10133 | 调用 addTasks 方法时,服务器认证错误。 |
rtmpTasks 参数有误。 |
请根据 RtcError 对象中的 extraCode 属性判断具体的服务器错误信息,也可以通过 console 日志查看错误原因及处理方式。 |
10134 | 参数有误,调用 deleteTasks 方法时参数传递有误。 |
taskIds 参数为空,或者该数组的长度为空。 |
请保证 taskIds 参数设置正确。 |
10135 | 调用 deleteTasks 方法时,服务器认证错误。 |
taskIds 参数有误,可能存在没有创建成功的 taskId 。 |
请根据 RtcError 对象中的 extraCode 属性判断具体的服务器错误信息,也可以通过 console 日志查看错误原因及处理方式。 |
10136 | 参数有误,调用 updateTasks 方法时参数传递有误。 |
rtmpTasks 参数为空,或者该数组的长度为空。 |
请保证 rtmpTasks 参数设置正确。 |
10137 | 调用 updateTasks 方法时,服务器认证错误。 |
rtmpTasks 参数有误。 |
请根据 RtcError 对象中的 extraCode 属性判断具体的服务器错误信息,也可以通过 console 日志查看错误原因及处理方式。 |
102XX 本地音视频采集播放相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10210 | 调用 NERTC.createSteam() 方法时传递的 uid 参数有误,uid 仅支持 string 和 number 两种类型的格式。 |
uid 非 string 或 number 类型,或者 uid 是 number 类型,但是值超过了 number 类型的最大值(2^53 - 1)。 |
请保证 uid 的数据类型正确;若需要使用较大值,请使用 string 格式。 |
10211 | 未指定要打开的媒体设备。 | 调用 NERTC.createSteam() 方法时,若未设置 auido 、video 、screen 等属性,则调用 init 方法时没有需要打开的音视频媒体。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 init 的调用。 |
10212 |
媒体设备打开失败。 |
请根据 |
请根据具体的信息处理,
|
10215 | 视频播放参数有误。 | 调用 play 方法时,设置了 playOptions.video 或 screen ,但是没有指定 viewInput 。 |
如果需要播放视频内容,需要制定 view 节点。 |
10216 | 参数有误,调用 setLocalRenderMode 或 setRemoteEenderMode 方法时,未传递 width 、height 等参数,或者传递的参数格式或数值有误。 |
- | 请保证参数设置正确。 |
10218 | 参数错误,调用 isPlaying 方法时未传递 type 参数,或者传递的参数格式或数值有误。 |
type 未设置为 'audio'、'audioSlave'、'video'、'screen' 中的任何一个值。 |
请保证 type 参数设置正确。 |
10220 | 参数错误,调用 open 方法时,未指定要开启的音视频设备,比如 audio 、video 、screen 或 screenAudio 。 |
- | 请保证参数设置正确。 |
10221 | 重复打开麦克风。 | 当前仍处于打开麦克风的过程中或者已经成功打开麦克风,又再次调用 open {audio: true} 方法。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 open 的调用。 |
10222 | 重复打开音频辅流。 | 当前仍处于打开音频辅流的过程中或者已经成功打开音频辅流,又再次调用 open {screenAudio: true, screen: true} 方法。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 open 的调用。 |
10223 | 重复打开摄像头。 | 当前仍处于打开摄像头的过程中或者已经成功打开摄像头,又再次调用 open {camera: true} 方法。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 open 的调用。 |
10224 | 重复打开屏幕共享。 | 当前仍处于打开屏幕共享的过程中或者已经成功打开屏幕共享,又再次调用 open {screen: true} 方法。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 open 的调用。 |
10228 | 参数有误,调用 close 方法时未指定要关闭的音视频设备,比如 audio 、video 、screen 或 screenAudio 。 |
- | 请保证参数设置正确。 |
10229 | 当前未打开麦克风,却调用 close {audio:true} 方法关闭麦克风。 |
- | 建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 close 的调用。 |
10230 | 当前未打开音频辅流,却调用 close {screenAudio:true} 方法关闭音频辅流。 |
- | 建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 close 的调用。 |
10231 | 当前未打开摄像头,却调用 close {video:true} 方法关闭摄像头。 |
- | 建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 close 的调用。 |
10232 | 当前未打开屏幕共享,却调用 close {screen:true} 方法关闭屏幕共享。 |
- | 建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 close 的调用。 |
10240 | 当前未订阅音频,却调用 setAudioVolume 方法设置播放音量。 |
- | 建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 setAudioVolume 的调用。 |
10241 | 当前未播放音频,却调用 setAudioSlaveVolume 方法设置播放音量。 |
- | 建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 setAudioSlaveVolume 的调用。 |
10242 | 参数有误,调用 setCaptureVolume 方法时,设置麦克风采集音量的 volume 参数格式错误,类型要求为 number,取值范围为 0 ~ 100。 |
- | 请保证 volume 参数设置正确。 |
10243 | 调用 unmuteAudio 方法失败。 |
当前未在播放音频,却调用 unmuteAudio 方法取消静音音频。 |
请先调用 play 方法播放音频。 |
10244 | 调用 unmuteAudioSlave 方法失败。 |
当前未在播放音频辅流,却调用 unmuteAudioSlave 方法取消静音音频辅流。 |
请先调用 play 方法播放音频辅流。 |
10245 | 调用 unmuteVideo 方法失败。 |
当前未在播放视频,却调用 unmuteVideo 方法取消静音音频辅流。 |
请先调用 play 方法播放视频。 |
10246 | 调用 unmuteScreen 方法失败。 |
当前未在进行屏幕共享,却调用 unmuteScreen 方法取消静音音频辅流。 |
请先调用 play 方法开启屏幕共享。 |
10247 | 调用 takeSnapshot 或 takeSnapshotBase64 方法失败。 |
当前未开启摄像头或开启摄像头后未播放视频,不支持截图。 | 请先调用 play 方法播放视频。 |
10248 | 调用 takeSnapshot 或 takeSnapshotBase64 方法失败。 |
当前浏览器环境不支持截图。 | 建议使用最新版本的 Chrome 浏览器。 |
10250 | 调用 setAudioVolume 方法失败。 |
参数有误,volume 不是 number 数据类型,或取值不在规定范围(0 ~ 100)内。 |
请保证 volume 参数设置正确。 |
10251 | 调用 setAudioVolume 方法失败。 |
当前未在播放音频,却调用 setAudioVolume 方法设置播放音量。 |
请先调用 play 方法播放音频。 |
10252 | 调用 setCaptureVolume 方法失败。 |
参数有误,volume 不是 number 数据类型,或取值不在规定范围(0 ~ 100)内。 |
请保证 volume 参数设置正确。 |
10253 | 调用 setAudioOutput 方法失败。 |
可能是浏览器不支持,或者在切换扬声器时,浏览器内部出现异常。 | 建议使用最新版本的 Chrome 浏览器或者联系云信技术支持。 |
10254 | 调用 switchDevice 方法失败。 |
参数有误,type 参数只能设置为 video 或 audio 。 |
请保证 type 参数设置正确。 |
10255 | 调用 switchDevice 方法失败。 |
状态错误,在前一次调用 switchDevice 方法还未生效时,又重复调用该方法。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 switchDevice 的调用。 |
10256 | 调用 switchDevice 方法失败。 |
状态错误,当前未打开麦克风设备,却调用 switchDevice 方法切换麦克风设备。 |
建议在业务层规避此行为。 |
10257 | 调用 switchDevice 方法失败。 |
音频数据是用户的自定义数据,不支持切换麦克风。 | 建议在业务层规避此行为。 |
10258 | 调用 switchDevice 方法失败。 |
状态错误,当前未打开摄像头设备,却调用 switchDevice 方法切换摄像头设备。 |
建议在业务层规避此行为。 |
10259 | 调用 switchDevice 方法失败。 |
视频数据是用户的自定义数据,不支持切换摄像头。 | 建议在业务层规避此行为。 |
10265 | 调用 muteAudio 方法失败。 |
当前不存在音频流,却调用 muteAudio 方法静音音频。 |
请先调用 play 方法播放音频。 |
10266 | 调用 unmuteAudio 方法失败。 |
当前未静音音频,却调用 unmuteAudio 方法取消静音。 |
建议在业务层规避此行为。 |
10267 | 调用 unmuteAudio 方法失败。 |
当前不存在音频流,却调用 unmuteAudio 方法静音音频。 |
请先保证存在音频数据。 |
10270 | 调用 muteAudioSlave 方法失败。 |
当前不存在音频流,却调用 muteAudioSlave 方法播放音频。 |
请先调用 play 方法播放音频。 |
10271 | 调用 unmuteAudioSlave 方法失败。 |
当前未静音音频,却调用 unmuteAudioSlave 方法取消静音。 |
建议在业务层规避此行为。 |
10272 | 调用 unmuteAudioSlave 方法失败。 |
当前不存在音频辅流,却调用 unmuteAudioSlave 方法静音音频辅流。 |
请先保证存在音频数据。 |
10275 | 调用 muteVideo 方法失败。 |
当前不存在视频流,却调用 muteVideo 方法静音视频。 |
请先调用 play 方法播放视频。 |
10276 | 调用 unmuteVideo 方法失败。 |
当前未静音视频,却调用 unmuteVideo 方法取消静音。 |
建议在业务层规避此行为。 |
10277 | 调用 unmuteVideo 方法失败。 |
当前不存在视频流,却调用 unmuteVideo 方法静音视频流。 |
请先保证存在视频数据。 |
10280 | 调用 muteScreen 方法失败。 |
当前不存在屏幕共享流,却调用 muteScreen 方法静音屏幕共享。 |
请先调用 play 方法开启屏幕共享。 |
10281 | 调用 unmuteScreen 方法失败。 |
当前未静音屏幕共享,却调用 unmuteScreen 方法取消静音屏幕共享。 |
建议在业务层规避此行为。 |
10282 | 调用 unmuteScreen 方法失败。 |
当前不存在屏幕共享流,却调用 unmuteScreen 方法静音屏幕共享流。 |
请先保证存在屏幕共享数据。 |
41030 | 音视频自动播放受限。 | 浏览器不允许在程序自动执行媒体播放功能。 | 请参考浏览器自动播放受限处理。 |
103XX 订阅和发布相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10350 | 调用 publish 方法发布媒体流失败。 |
publish 接口中的 localStream 错误,该 stream 中没有开启过任何媒体,所以无法发布。 |
请先开启音频、视频或者音视频之后再调用 publish 方法发布媒体流。 |
10351 | 当前是观众模式,不允许调用 publish 方法发布媒体流。 |
调用过 setClientRole 方法设置用户为观众角色,但观众无法发布媒体流。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 publish 的调用。 |
10355 | 服务器异常导致的发布失败。 | 请根据 RtcError 对象中的 message 信息判断具体原因。 |
请联系云信技术支持,并提供具体信息。 |
10360 | 服务器异常导致的订阅失败。 | 请根据 RtcError 对象中的 message 信息判断具体原因。 |
请联系云信技术支持,并提供具体信息。 |
1040X 插件模块相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10401 | 不支持美颜、虚拟背景或 AI 降噪功能。 | 当前浏览器不支持 WebGL 语言。 | 建议最新版本的 Chrome 浏览器。 |
10406 | 插件加载错误。 | 插件路径或者系统内容错误,请根据 RtcError 对象中的 message 信息判断具体原因。 |
请检查设置的插件路径是否正确;如果正确无误,仍然加载失败,请联系云信技术支持。 |
10409 | 插件未注册。 | 调用 enable 相关方法开启虚拟背景、美颜或 AI 降噪插件前,未先注册插件。 |
请先调用 registerPlugin 接口注册插件。 |
1042X ~ 1043X 伴音音效相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10420 | 当前没有正在播放的音频,所以无法开启伴音。 | 当前没有开启麦克风,不支持伴音功能。 | 请先开启麦克风。 |
10421 | 伴音文件加载失败。 | 调用 startAudioMixing 方法时,传递的 audioFilePath 参数有误、该路径的 http 请求失败,或者该伴音文件数据格式错误。 |
请检查 audioFilePath 对应的伴音文件是否正常。 |
10422 | 不支持伴音功能。 | 当前浏览器不支持伴音功能。 | 建议使用最新版本的 Chrome 浏览器。 |
10423 | 伴音功能的相关接口调用失败。 | 当前没有正在进行中的伴音任务,却调用相关接口停止、暂停播放伴音文件或调节伴音音量。 | 请先调用 startAudioMixing 方法开启伴音。 |
10424 | 调用 resumeAudioMixing 方法失败。 |
当前没有暂停伴音,却调用 resumeAudioMixing 方法恢复播放伴音。 |
建议在业务层规避此行为。 |
10425 | 调用 adjustAudioMixingVolume 方法时,传递的参数有误。 |
volume 不是 number 数据类型,或取值不在规定范围(0 ~ 255)内。 |
请保证 volume 参数设置正确。 |
10426 | 调用 setAudioMixingPosition 方法时,传递的参数有误。 |
playStartTime 的格式错误或者取值不在规定范围(大于 0,且小于伴音文件的总时长)内。 |
请保证 playStartTime 参数设置正确。 |
10430 | 不支持音效功能。 | 当前浏览器不支持音效功能。 | 建议使用最新版本的 Chrome 浏览器。 |
10431 | 音效文件加载失败。 | 调用 playEffect 或 preloadEffect 方法时,传递的 filePath 参数有误、该路径的 http 请求失败,或者该伴音文件数据格式错误。 |
请检查 filePath 对应的音效文件是否正常。 |
10432 | 当前没有正在播放的音频,所以无法开启伴音。 | 当前没有开启麦克风,不支持音效功能。 | 请先开启麦克风。 |
10433 | 音效功能的相关接口调用失败。 | 当前没有正在进行中的音效任务,却调用相关接口停止、暂停播放音效文件或调节音效音量。 | 请先调用 playEffect 方法开启音效。 |
10434 | 未找到 soundId 对应的音效文件。 |
soundId 对应的音效文件未加载成功或已经释放,或者参数错误。 |
请检查 soundId 参数是否正确。 |
10435 | 调用 resumeEffect 方法失败。 |
当前没有暂停音效,却调用 resumeEffect 方法恢复播放音效。 |
建议在业务层规避此行为。 |
10436 | 调用 unloadEffect 方法失败。 |
该音效文件正在播放,不能释放。 | 请先调用 stopEffect 方法停止播放音效文件。 |
10437 | 音效功能内部状态异常。 | 在已经播放音效文件后,或者当前音效文件处于暂停、加载中时,又调用 playEffect 方法导致 SDK 内部状态异常。 |
请联系云信技术支持,并提供具体信息。 |
1044X 其他业务功能模块相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10445 | 参数有误,调用 setLocalMediaPriority 方法时,传递的 priority 参数格式错误。 |
priority 参数不是 number 类型或者取值不是 50 或 100。 |
请保证 priority 参数设置正确。 |
10446 | 调用 updatePermKey 方法失败。 |
服务器拒绝更新 permKey 的请求。 |
请根据 RtcError 对象中的 extraCode 属性判断具体的错误信息,也可以通过 console 日志查看错误原因及处理方式。 |
1045X ~ 10460 客户端录制及水印相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10450 | 调用 startMediaRecording 方法失败。 |
当前浏览器环境不支持客户端录制功能。 | 建议使用最新版本的 Chrome 浏览器。 |
10451 | 调用 startMediaRecording 方法失败。 |
重复调用 startMediaRecording 方法。 |
建议在业务层规避此行为,也可以忽略该报错,因为 SDK 会主动放弃该次 startMediaRecording 的调用。 |
10452 | 调用 startMediaRecording 方法失败。 |
对于之前的录制数据尚未进行下载或清除操作。 | 请调用 downloadMediaRecording 方法下载录制数据或者调用 cleanMediaRecording 方法清除数据。 |
10453 | 录制过程中内部出现异常。 | SDK 内部异常。 | 请联系云信技术支持,并提供具体信息。 |
10454 | 调用 stopMediaRecording 或 cleanMediaRecording 方法失败。 |
当前没有进行中的录制任务。 | 建议在业务层规避此行为,在没有开启录制任务的情况下,禁止调用这些接口。 |
10460 | 调用 setCanvasWatermarkConfigs 方法失败。 |
设置的文字水印数量超过 10 个 或者图片水印超过 4 个。 | 请在业务层规避此行为。 |
1046X ~ 10470 LBS 模块相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10461 | LBS 请求相关异常。 | 由于网络问题导致 SDK 发起 LBS 请求失败。 | 建议先尝试切换网络,如果一直不成功,请联系云信技术支持。 |
10472 | LBS 请求相关响应的结果解析异常。 | 内部流程异常。 | 请联系云信技术支持,并提供具体信息。 |
10471 ~ 10476 加密相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10471 | 当前浏览器环境不支持自定义加密功能。 | - | 建议使用最新版本的 Chrome 浏览器。 |
10472 | 自定义加密功能与国密加密功能不兼容。 | 同时调用 setEncryptionMode 和 enableCustomTransform 方法开启国密加密功能和自定义加密功能,但两种加密功能互斥。 |
请在业务层规避此行为,同一时间只能使用一种加密方式。 |
10473 | 调用 setEncryptionSecret 方法失败。 |
未先调用 setEncryptionMode 开启国密加密功能,无法设置加密密钥。 |
请先调用 setEncryptionMode 开启了国密加密功能。 |
10477 ~ 10479 用户角色相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10477 | 调用 setClientRole 方法时,传递的 role 参数格式错误。 |
role 参数不是host 或 audience 。 |
1048X 获取接口相关错误码
错误码 | 说明 | 可能原因 | 处理建议 |
---|---|---|---|
10480 | 调用 getSystemStats 方法失败。 |
当前浏览器环境不支持。 | 建议使用最新版本的 Chrome 浏览器。 |
其他常见报错及处理建议
错误信息 | 说明 | 处理建议 |
---|---|---|
getUserMedia error: NotAllowedError | 用户拒绝了当前的浏览器实例访问音频、视频或屏幕分享的请求。 | 用户需要授权摄像头/麦克风访问,才能进行音视频通话。 |
getUserMedia error: NotFoundError | 找不到满足请求参数的媒体类型,如音频,视频。 | 建议通话前进行设备检测,确认设备状态正常。 |
getUserMedia error: NotReadableError | 操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问。 | 请确保当前麦克风/摄像头没有被其他设备占用。 |
getUserMedia error: OverconstrainedError | 浏览器无法获取到媒体设备的 deviceId ,如 cameraId /microphoneId 。 |
请确保 cameraId /microphoneId 是符合要求的非空字符串。 |
getUserMedia error: TypeError | 当前使用的是 http 协议。 | 请确保当前使用的是 https 协议。 |
此文档是否对你有帮助?