错误码和状态码 - 音视频通话 2.0

开发者中心

音视频通话 2.0

客户端 API

错误码和状态码

更新时间： 2023/10/23 11:56:29

本文介绍 NERTC SDK Unreal Engine V5 版本的错误码。

通用错误码

错误码	错误信息	说明	处理建议
0	kNERtcNoError	成功	无需处理。
403	kNERtcErrChannelReservePermissionDenied	描述：权限不足。可能原因：未开通音视频通话 2.0 服务，或试用期已过、未及时续费等。安全模式下加入房间时未设置 Token。其他权限问题。
408	kNERtcErrChannelReserveTimeOut	描述：请求超时。可能原因：可能是网络延时较大。	建议切换网络重新尝试。
414	kNERtcErrChannelReserveErrorParam	描述：服务器请求参数错误。可能原因：请求参数格式不正确，例如缺少必要的参数或参数类型不正确。请求参数值不正确，例如参数值超出范围或不符合要求。	请检查请求参数是否正确
417	kNERtcErrChannelReserveErrorAppKey	描述：非法的AppKey。可能原因：AppKey填写错误。	请检查输入的 AppKey 是否和云信控制台对应应用的 AppKey 一致。
500	kNERtcErrChannelReserveServerFail	描述：分配房间时出现服务器未知错误。	请联系网易云信技术支持。
600	kNERtcErrChannelReserveMoreThanTwoUser	描述：登录房间的用户数超过限制的两人。可能原因：该房间设置了只允许两个用户加入，第三个用户加入房间时报错。	建议应用侧提示用户对应的错误信息。
901	kNERtcErrChannelPermissionKeyError	描述：登录房间时权限密钥错误，原错误码为30901。可能原因：您开启了高级Token 鉴权，但 permissionKey 中没有分配对应的权限；或者用户角色变更时，没有重新设置新的权限密钥。	请检查该用户的 PermissionKey，是否具备该操作权限，具体请参见高级 Token 鉴权。例如，在用户连麦时，需要将自己的角色从观众切换到主播，此时需要再次校验用户的发流权限。因此在用户调用 setClientRole 方法切换角色时，需要调用 updatePermissionKey 方法设置新的权限密钥。
902	kNERtcErrChannelPermissionKeyTimeout	描述：登录房间时权限密钥过期。原错误码为30902。可能原因：您开启了高级Token 鉴权，但密钥过期。	从您的业务服务器获取新的 permissionKey 并调用 updatePermissionKey 方法将新生成的 permissionKey 传递给 SDK，具体请参见高级 Token 鉴权。
1301	kNERtcErrLsTaskRequestInvalid	描述：task请求无效，因为该请求被后续操作覆盖了。可能原因：在发送请求时，同时进行了其他操作，导致该请求被覆盖或被取消。	请确保在发送请求时不要进行其他操作，或者等待请求完成后再进行其他操作。
1400	kNERtcErrLsTaskIsInvaild	描述：推流的参数格式错误。可能原因：请求中包含了无效的参数或缺少了必要的参数。	请检查请求中的参数是否正确，并确保所有必要的参数都已包含在请求中。
1401	kNERtcErrLsTaskRoomExited	描述：房间已经退出。	建议应用侧提示用户对应的错误信息。
1402	kNERtcErrLsTaskNumLimit	描述：推流任务超出上限。	一个房间中，只能创建6个推流任务。
1403	kNERtcErrLsTaskDuplicateId	描述：推流 ID 重复。可能原因：房间中已存在该推流 ID。	更换新的流 ID。调整流名生成策略，保证推流 ID 唯一性。
1404	kNERtcErrLsTaskNotFound	描述：taskId任务不存在，或房间不存在。	请检查taskId是否正确或房间是否存在。
1417	kNERtcErrLsTaskRequestErr	描述：请求失败。	请检查网络连接状态，并确保网络稳定。
1500	kNERtcErrLsTaskInternalServerErr	描述：服务器内部错误。	请联系网易云信技术支持。
1620	kNERtcErrChannelNoPublishPermission	描述：用户无发流权限。原错误码为30911。可能原因：您开启了高级Token 鉴权， permissionKey 中没有给该用户分配对应的权限；或者用户角色变更时，没有重新设置新的权限密钥。	请检查该用户的 PermissionKey，是否具备该操作权限，具体请参见高级 Token 鉴权。例如，在用户连麦时，需要将自己的角色从观众切换到主播，此时需要再次校验用户的发流权限。因此在用户调用 setClientRole 方法切换角色时，需要调用 updatePermissionKey 方法设置新的权限密钥。
2803	kNERtcErrChannelNoSubscribePermission	描述：用户无订阅权限。原错误码为30912。可能原因：您开启了高级Token 鉴权， permissionKey 中没有给该用户分配对应的权限；或者用户角色变更时，没有重新设置新的权限密钥。	请检查该用户的 PermissionKey，是否具备该操作权限，调用 updatePermissionKey 方法设置新的权限密钥，具体请参见高级 Token 鉴权。
4003	kNERtcErrServerPersonsInRoomReachedTheLimit	描述：加入房间的人数达到限制。
30001	kNERtcErrFatal	描述：内部错误。	请联系网易云信技术支持。
30002	kNERtcErrOutOfMemory	描述：内存溢出。
30003	kNERtcErrInvalidParam	描述：参数错误。
30004	kNERtcErrNotSupported	描述：不支持的操作。
30005	kNERtcErrInvalidState	描述：状态错误。
30006	kNERtcErrLackOfResource	描述：缺乏资源。
30007	kNERtcErrInvalidIndex	描述：index序号非法。
30008	kNERtcErrDeviceNotFound	描述：设备未找到。可能原因：设备 ID 拼写错误、对应设备被插拔、设备未连接。	请使用 SDK 的接口来获取设备 ID, 检查设备是否正确连接。
30009	kNERtcErrInvalidDeviceSourceID	描述：设备 ID 不存在。可能原因：设备 ID 拼写错误，或者对应设备被插拔	请使用 SDK 的接口来获取设备 ID, 检查设备是否正确连接。
30011	kNERtcErrCreateDeviceSourceFail	描述：创建设备失败。	请确保设备可用，并检查是否有其他程序占用了设备资源。
30014	kNERtcErrTransmitPendding	描述：传输错误。	请检查传输过程中的网络连接状态。
30015	kNERtcErrConnectFail	描述：连接服务器失败。	请检查网络连接状态，并确保服务器地址正确。
30016	kNERtcErrCreateDumpFileFail	描述：创建 Audio Dump 文件失败。	请检查文件系统权限，并确保文件路径正确。
30017	kNERtcErrStartDumpFail	描述：开启 Audio Dump失败。	请检查文件系统权限，并确保文件路径正确。
30100	kNERtcErrChannelAlreadyJoined	描述：重复加入房间。可能原因：用户已在房间内，重复调用加入房间的接口	无需处理。
30101	kNERtcErrChannelNotJoined	描述：用户未加入房间。	请调用 joinRoom 加入房间后，再调用该接口。
30102	kNERtcErrChannelRepleatedlyLeave	描述：重复离开房间。可能原因：用户已离开房间，重复调用离开房间的接口	无需处理。
30103	kNERtcErrRequestJoinChannelFail	描述：请求加入房间失败。可能原因：请求加入房间时出现了错误或者房间已满。	请确保请求加入房间的参数正确，并尝试重新加入房间。
30104	kNERtcErrSessionNotFound	描述：会话未找到。可能原因：会话已经过期或者会话信息不正确。	请检查会话信息是否正确，并尝试重新创建或者加入会话。
30105	kNERtcErrUserNotFound	描述：用户不存在。可能原因：请求操作的用户不存在或者用户已经离开房间。	请确保请求操作的用户存在，并检查用户是否已经离开房间。
30106	kNERtcErrInvalidUserID	描述：非法用户。可能原因：请求操作的用户ID不合法。	请检查请求操作的用户ID是否正确，并确保用户ID符合规范。
30107	kNERtcErrMediaNotStarted	描述：用户多媒体数据未连接。	请确保用户的多媒体数据连接已经建立，并检查网络连接状态。
30108	kNERtcErrSourceNotFound	描述：媒体源未找到。可能原因：请求的媒体源不存在或者未正确配置。	请检查请求的媒体源是否存在，并确保媒体源已正确配置。
30109	kNERtcErrSwitchChannelInvalidState	描述：切换房间时，当前不在任何房间中。	请调用 joinChannel 加入房间后，才能切换房间。
30110	kNERtcErrChannelMediaRelayInvalidState	描述：媒体流转发状态无效。可能原因：重复调用 startChannelMediaRelay	成功调用startChannelMediaRelay后，必须先调用 stopChannelMediaRelay 方法退出当前的媒体流转发状态，才能再次调用 startChannelMediaRelay 方法。
30111	kNERtcErrChannelMediaRelayPermissionDenied	描述：没有权限转发媒体流。可能原因：源房间的房间类型为双人房间（1V1模式）。此时无法转发媒体流。调用 startChannelMediaRelay 开启媒体流转发的成员角色为观众角色，仅主播角色可以转发媒体流。	房间的场景属性为直播模式，才能转发媒体流。仅主播角色可以调用startChannelMediaRelay 转发媒体流。
30112	kNERtcErrChannelMediaRelayStopFailed	描述：停止媒体流转发操作失败。可能原因：未开启媒体流转发。	请确认调用 stopChannelMediaRelay 前，是否已成功调用 startChannelMediaRelay 开启媒体流转发。
30113	kNERtcErrEncryptNotSuitable	描述：设置的媒体流加密密钥与房间中其他成员不一致，加入房间失败。	请通过 enableEncryption 重新设置加密密钥。
30121	kNERtcErrUserPermKeyAuthFailed	描述：高级 Token 鉴权失败，用户权限验证错误。可能原因：应用已开通高级 Token 鉴权，但用户鉴权时没有传入 permissionKey 参数。应用已开通高级 Token 鉴权，且用户鉴权时传入了 permissionKey 参数，但用户没有对应权限。应用已开通高级 Token 鉴权，且用户鉴权时传入了 permissionKey 参数，但用户的 permissionKey 已失效。	请配置正确的 permissionKey，具体请参见高级 Token 鉴权。
30122	kNERtcErrSEIExceedMaxDataLimit	描述：SEI 超过最大数据限制。	发送的 SEI 数据长度应小于 4096 字节
30123	kNERtcErrDataChannelExceedMaxDataLimit	描述：数据通道发送大小超过限制。
30200	kNERtcErrConnectionNotFound	描述：连接未找到。	请检查连接是否存在或已经被关闭。
30201	kNERtcErrStreamNotFound	描述：媒体流不存在。
30202	kNERtcErrAddTrackFail	描述：添加媒体播放器音轨失败。	请检查媒体播放器音轨是否可用，并确保正确添加。
30203	kNERtcErrTrackNotFound	描述：媒体播放器音轨未找到。可能原因：指定的音轨不存在。	检查播放文件的音轨。
30204	kNERtcErrMediaConnectionDisconnected	描述：媒体连接已断开。	请检查网络是否正常，或切换网络。
30205	kNERtcErrSignalDisconnected	描述：信令断开。	请检查网络连接状态，并确保网络稳定。
30206	kNERtcErrServerKicked	描述：用户被管理员移出房间。可能原因：房主或管理员将该用户从房间移出。	无需处理。
30207	kNERtcErrKickedForRoomClosed	描述：房间已关闭。可能原因：房主关闭了房间，或全部用户离开房间后，房间自动关闭	无需处理。
30208	kNERtcErrChannelLeaveBySwitchAction	描述：因为切换房间而离开房间。
30209	kNERtcErrChannelLeaveByDuplicateUidLogin	描述：因为重复 UID 登录而离开房间。可能原因：该 UID 的用户已登录房间。	无需处理。
40000	kNERtcRuntimeErrADMNoAuthorize	描述：没有音频设备的权限。可能原因：没有申请或者获得对应音频设备的使用权限。	请检查应用是否正确申请了麦克风的权限，以及用户是否授予了相应权限。
40001	kNERtcRuntimeErrADMInitRecording	描述：初始化音频采集设备（麦克风）失败。可能原因：音频采集设备被其他应用占用。	请检查音频采集设备是否被其他应用占用，或者尝试重新进入房间。
40002	kNERtcRuntimeErrADMStartRecording	描述：启动音频采集设备（麦克风）失败。
40003	kNERtcRuntimeErrADMStopRecording	描述：停止音频采集设备（麦克风）失败。
40004	kNERtcRuntimeErrADMInitPlayout	描述：初始化音频播放设备失败。	请检查音频播放设备是否被其他应用占用，或者尝试重新进入房间。
40005	kNERtcRuntimeErrADMStartPlayout	描述：音频播放设备启动失败。	请确保播放设备未被其他应用程序占用，并检查播放设备的配置是否正确。
40006	kNERtcRuntimeErrADMStopPlayout	描述：音频播放设备停止失败。	请检查播放设备是否已经正确关闭，并确保播放设备正常运行。
40007	kNERtcRuntimeErrADMRecordingFailed	描述：音频采集设备运行异常。	请确保采集设备已正确配置，并检查采集设备是否出现异常。
40008	kNERtcRuntimeErrADMPlayoutFailed	描述：音频播放设备运行异常。	请确保播放设备已正确配置，并检查播放设备是否出现异常。

此文档是否对你有帮助？

有帮助

去反馈

通用错误码