错误码 - 音视频通话 2.0

开发者中心

音视频通话 2.0

客户端 API

错误码

更新时间： 2025/03/05 10:33:26

在调用网易云信音视频通话 2.0 Web SDK API 的过程中，SDK 可能会返回错误码或状态码，您可以根据错误码或状态码判断当前 SDK 或任务的状态。如果遇到未知的错误码，请提交工单联系网易云信技术支持工程师排查。

V4.6.40 及之后版本的错误码

100XX 通用错误码

错误码	说明	可能原因	处理建议
10000	通用参数错误	参数缺失、格式错误等。	请根据 `RtcError` 对象中的 `message` 信息判断具体错误的参数，也可以通过 console 日志查看错误原因及处理方式。
10001	系统环境不支持网易云信 SDK 运行。	调用 `createClient`、`createStream` 或 `getDevices` 接口时，浏览器版本过低、浏览器不支持或没有使用 https 环境。	请前往开发文档查阅网易云信 SDK 支持的系统浏览器环境，也可以通过 console 日志查看错误原因及处理方式。
10002	网络环境异常，导致网易云信服务器连接彻底失败。	用户网络问题，例如防火墙限制、网络连接不成功或网易云信服务器异常。	请先检查个人网络，可以尝试切换网络。若确认网络没有问题，请稍后重试或联系网易云信技术支持。
10003	HTTP 请求发生错误。	用户网络问题，例如防火墙限制、网络连接不成功或网易云信服务器异常，具体原因可以查看 `RtcError` 对象中的 `message` 信息。	请先检查个人网络，可以尝试切换网络。若确认网络没有问题，请稍后重试或联系网易云信技术支持。
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 等信息错误。	请根据 `RtcError` 对象中的 `extraCode` 属性判断具体的错误信息，也可以通过 console 日志查看错误原因及处理方式。其中 `extraCode` 可能出现的值如下： 400：参数格式错误，一般在版本升级时可能会出现。请联系网易云信技术支持。 401、403：鉴权错误。请检查 App Key、Token 的信息是否正确，以及该 App Key 是否开通了网易云信相应的服务。 414：参数错误。请检查调用 `join` 方法时传递的参数 `key` 关键字是否有误。 500：服务器内部错误。请联系网易云信技术支持。 4005：黑名单。请联系网易云信技术支持。 4006：短时 Token 认证错误。请联系网易云信技术支持。 4010：自定义加密配置的内容不匹配。请检查房间中各自的加密信息设置是否相同。 4011：已开通短时 Token 功能，但加入房间时未传递 `permKey` 参数。请检查调用 `join` 方法时是否设置了 `permKey` 参数。 4012：已开通短时 Token 功能，且加入房间时携带了 `permKey` 参数，但是没有权限。请检查 `permKey` 的生成规则，是否赋予了加入房间的权限。 4013：已开通短时 Token 功能，且加入房间时携带了 `permKey` 参数，但是 `permKey` 已经过期等。请检查 `permKey` 的生成规则，是否已经过期了。 4014：关于短时 Token 的其他认证错误。请联系网易云信技术支持。 -1：SDK 内部错误。请联系网易云信技术支持。
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	媒体设备打开失败。	请根据 `RtcError` 对象中的 `message` 信息判断具体原因。	请根据具体的信息处理，`message` 可能返回的信息如下： `NotAllowedError` `NotFoundError` `NotReadableError` `OverConstrainedEerror`
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 ~ 1041X 插件模块相关错误码

错误码	说明	可能原因	处理建议
10401	不支持美颜、虚拟背景或 AI 降噪功能。	当前浏览器不支持 WebGL 语言。	建议最新版本的 Chrome 浏览器。
10406	插件加载错误。	插件路径或者系统内容错误，请根据 `RtcError` 对象中的 `message` 信息判断具体原因。	请检查设置的插件路径是否正确。如果正确无误，仍然加载失败，请联系网易云信技术支持。
10409	插件未注册。	调用 `enable` 相关方法开启虚拟背景、美颜或 AI 降噪插件前，未先注册插件。	请先调用 `registerPlugin` 接口注册插件。
10410	不支持该插件。	插件版本不适配主版本，不支持 simd 版本的浏览器使用了 simd 库，插件 js 和 wasm 文件不匹配等。	请检查插件源文件。
10411	插件不支持该浏览器版本。	每个插件都有最低支持的浏览器版本，如果浏览器版本过低，会提示该错误。	请检查浏览器版本是否匹配。
10412	WebGL 初始化未完成。	在内部 webGL 初始化未完成时，调用了美颜、虚拟背景等功能。	-
10413	插件版本错误。	插件版本同主版本不匹配，导致插件无法正常使用(从 v5.6.0 版本开始，插件版本和 SDK 版本需保持一致)	请检查插件版本和主 sdk 版本。

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`。	请正确填写参数，参数选项为 `host` 或 `audience`。

1048X 获取接口相关错误码

错误码	说明	可能原因	处理建议
10480	调用 `getSystemStats` 方法失败。	当前浏览器环境不支持。	建议使用最新版本的 Chrome 浏览器。

1049X 人数限制相关错误码

错误码	说明	可能原因	处理建议
10490（SET_CLIENT_ROLE_ERROR）	调用 `Client.setClientRole` 方法，用户角色从观众切换为主播失败。	主播数量已达上限，限制为 60 人。	-

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.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	未知原因错误。请联系网易云信技术支持。

其他常见报错及处理建议

错误信息	说明	处理建议
getUserMedia error: NotAllowedError	用户拒绝了当前的浏览器实例访问音频、视频或屏幕分享的请求。	用户需要授权摄像头/麦克风访问，才能进行音视频通话。
getUserMedia error: NotFoundError	找不到满足请求参数的媒体类型，如音频，视频。	建议通话前进行设备检测，确认设备状态正常。
getUserMedia error: NotReadableError	操作系统上某个硬件、浏览器或者网页层面发生的错误导致设备无法被访问。	请确保当前麦克风/摄像头没有被其他设备占用。
getUserMedia error: OverconstrainedError	浏览器无法获取到媒体设备的 `deviceId`，如 `cameraId`/`microphoneId`。	请确保 `cameraId`/`microphoneId` 是符合要求的非空字符串。
getUserMedia error: TypeError	当前使用的是 http 协议。	请确保当前使用的是 https 协议。

此文档是否对你有帮助？

有帮助

去反馈

V4.6.40 及之后版本的错误码
100XX 通用错误码
101XX 房间相关错误码
102XX 本地音视频采集播放相关错误码
103XX 订阅和发布相关错误码
1040X ~ 1041X 插件模块相关错误码
1042X ~ 1043X 伴音音效相关错误码
1044X 其他业务功能模块相关错误码
1045X ~ 10460 客户端录制及水印相关错误码
1046X ~ 10470 LBS 模块相关错误码
10471 ~ 10476 加密相关错误码
10477 ~ 10479 用户角色相关错误码
1048X 获取接口相关错误码
1049X 人数限制相关错误码
V4.6.25 版本的错误码
V4.6.25 之前版本的错误码
其他常见报错及处理建议