状态码

RTCLib 状态码

1004

JWT_TIME_OUT

JWT token 解析超时，需要刷新 navi 重新获取。

排查建议：

1. 可清空浏览器 localStorage，再刷新页面重试。
2. 重试任有问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

10000

SUCCESS

成功。

40001

PB_ERROR

PB 错误。

排查建议：

1. 该错误一般是 rtcPing 失败导致。
2. 请稍后重试。若重试多次，仍无法解决问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

50000

SIGNAL_DISCONNECTED

初始化失败或 IM 未连接。

排查建议：

1. 用户可调用getConnectionStatus()来确认当前连接状态。
2. RTC SDK 异步接口需等connect 连接成功后才能调用。

50001

PARAMS_ERROR

接口参数错误。

排查建议：请通过API DOC检查接口参数类型是否正确。

50002

REPERT_JOIN_ROOM

加入相同房间错误，表示用户在客户端重复加入相同的房间。

排查建议：业务层可通过room.getRoomId()获取当前用户加入的房间 ID，判断是否重复加入。

50003

NOT_IN_ROOM

调用房间内接口时，不在房间中。

排查建议：

1. 业务层请检查是否有主动离开房间的操作。
2. 如果没有主动离开，请检查room.registerRoomEventListener房间事件的 onKickOff 是否有触发，可根据回调信息判断被踢出房间原因。

50004

SERVICE_INVALID

未开通音视频服务，请到融云控制台开启。

排查建议：可在融云控制台 > 应用配置 > 音视频服务 > 实时音视频开通服务。

50006

RTC_TOKEN_INVALID

RTC token 为空。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

53001

SIGNAL_ERROR

底层信令调用错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

53003

CREATE_OFFER_FAILED

创建 Offer 失败。

排查建议：该错误码已定义，暂未使用。

53004

REQUEST_FAILED

网络请求失败。

排查建议：网络异常，请稍后重试。若重试多次，仍无法解决问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

53005

MCU_SERVER_NOT_FOUND

MCU 地址不可为空。

排查建议：mcu 地址是通过 exchange 接口返回

1. 可以在控制台 Network 中找到 exchange 请求的返回结果。
2. 请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间以及 exchange 返回的结果。

53007

BROADCAST_SUB_LIST_NOT_EMPTY

直播订阅失败，当前存在已订阅资源。

排查建议：建议用户先调用unsubscribe取消订阅旧资源，再重新subscribe订阅新资源。

53008

ROOM_HAS_BEEN_DESTROYED

房间已被销毁，需重新加入房间获取 Room 实例。

排查建议：需要业务层重新调用加入房间的接口，详情请参阅创建/加入房间。

53009

NOT_OPEN_VIDEO_AUDIO_SERVER

没有可用的音视频服务器地址。

排查建议：

1. 可在融云控制台 > 应用配置 > 音视频服务 > 实时音视频确认音视频服务是否开通。
2. 如果已开通，且间隔时间已有 30 分钟，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

53010

GET_USER_MEDIA_FAILED

获取用户媒体资源流失败。

排查建议：

1. 请检查当前设备的麦克风和摄像头是否正常。
2. 请检查浏览器是否有权限获取麦克风和摄像头。
3. 可通过线上地址检测媒体设备是否正常获取。

53011

GET_DISPLAY_MEDIA_FAILED

获取屏幕共享流失败。

排查建议：

1. 可通过线上地址检测浏览器是否能正常获取。
2. SDK 也是通过getDisplayMedia获取屏幕共享的，请确认是否已打开屏幕共享的权限。

53012

BROWSER_PERMISSION_DENIED

权限问题导致获取媒体流被拒绝。

排查建议：请检查浏览器是否有权限获取麦克风和摄像头。

53013

CREATE_CUSTOM_TRACK_FAILED

创建自定义流失败。

排查建议：

1. 请检查传入参数是否符合接口要求，文档详情请参阅发布自定义流。
2. 如果传参正确，仍有问题，请提交工单与我们联系，并附上必要的的信息，如 控制台报错，接口参数详细 等。

53014

INVALID_TAGS

无效的 TAG 定义。

排查建议：请通过API DOC检查接口参数类型是否正确。

53015

INVALID_USER_ID

IM 连接无效，无法识别当前登录的用户身份。

排查建议：

1. IM 连接异常，检查是否有调用connect连接成功。
2. 用户可以根据Events.SUSPEND 或者 Events.DISCONNECT 事件监听返回的错误码，判断连接异常原因。
3. 尝试更换稳定点网络重新连接，仍然出现请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID， 问题发生时间等。

53016

CREATE_FILE_TRACK_FAILED

创建文件流失败。

排查建议：

1. 当创建自定义流时，无法获取视频元素 (video)的媒体流 (MediaStream)。
2. 请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID， 问题发生时间等。

53017

INVALID_FILE_INSTANCE

无效的 File 实例。

排查建议：请通过API DOC检查接口参数类型是否正确。

53018

SET_REMOTE_DESCRIPTION_FAILED

setRemoteDescription failed。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID， 问题发生时间等。

53019

BROWSER_NOT_SUPPORT

浏览器不支持此方法。

排查建议： 使用 navigator 异常。

1. 请检查当前项目的 web 站点是否为 https 或者 http://localhost。
2. 参考下面代码可本地检测：

function ifSupportScreenShare(): boolean {
  return 'mediaDevices' in navigator && 'getDisplayMedia' in navigator.mediaDevices;
}

53020

TRACK_NOT_READY

媒体流无法播放，可能是远端流未订阅或本地流已销毁。

排查建议：房间事件onTrackReady回调中会返回可播放的媒体资源，业务层拿到资源后可按需播放。

53021

VIDEO_TRACK_MISS_MEDIA_ELEMENT

视频流播放需时需传参 HTMLVideoElement 作为显示组件。

排查建议： 在执行paly方法时，可使用 element instanceof HTMLVideoElement 判断传入的参数是否是一个有效的 video 标签。

53022

TRACK_PLAY_ERROR

媒体流播放失败。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID， 问题发生时间，控制台报错信息等。

53023

SIGNAL_AUDIENCE_JOIN_ROOM_FAILED

观众加入直播房间信令错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID， 问题发生时间，控制台报错信息等。

53024

SIGNAL_ROOM_CHANGE_IDENTITY_FAILED

直播房间切换身份错误。

排查建议：请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID， 问题发生时间，控制台报错信息等。

53025

PACKAGE_ENVIRONMENT_ERROR

公有云 SDK 包不允许使用私有云环境。

排查建议：该错误码适用于私有云，公有云用户可忽略。

53026

PUBLISH_TRACK_LIMIT_EXCEEDED

单个用户发布资源超过限制。

排查建议：MediaServer 限制发布资源最多 10 个 Track。

53027

CDN_RESOURCE_IS_EMPTY

房间内无主播推 CDN。

排查建议：

1. 请检查[融云控制台 > 应用配置 > 音视频直播 > 融云 CDN] 服务是否开通。
2. 如果服务已开通，并且间隔时间 15 分钟以上，请检查业务层是否有调用enableInnerCDN接口。

53028

SIGNAL_JOIN_RTC_ROOM_REFUSED

加入 RTC 房间 joinTYype 为 1 时，当前有其他端在房间时的应答码。

排查建议：

1. 当加入房间传的 joinType 为 1 时，表示保持已存在于房间的设备，拒绝当前设备加入房间，详情请参阅API DOC。
2. 请检查该用户其他端登入情况。

53029

NO_PERMISSION_TO_USE_REQUESTED_DEVICE

设置音频输出设备时，无权限使用请求的设备。

排查建议：请检查输出设备权限。

53030

THE_FUNCTION_IS_DISABLED_IN_PKROOM

方法在 PK 房间上不可用。

排查建议：请检查是否有发起连麦邀请并加入副房间，详情请参阅跨房间连麦。

53031

SOME_TRACKS_PUBLISH_FAILED

资源没有全部发成功。

排查建议：兼容老版本 SDK 错误码。

53032

MAC_IN_ELECTRON_NOT_SUPPORT_SCREEN_SHARE_WITH_AUDIO

electron 中 mac 系统暂不支持屏幕共享采集声音。

排查建议：设备系统兼容问题。

53033

SYSTEM_PERMISSION_DENIED

获取媒体资源时，无系统权限。

排查建议：请检查浏览器是否有权限获取麦克风和摄像头。

53034

PUBLISH_TRACKS_IS_INVALID

发布时无有效资源，如 track 已被销毁。

排查建议：检查 publish 传入的 tracks 是否正确，并且长度大于 0。

53035

TRACK_READYSTATE_IS_ENDED

【已废弃】流状态为 ended。

53036

APPLY_3A_NOISE_WORKLET_BEFORE_PUBLISH

应用 3A 降噪必须在 publish 之前。

排查建议：需要保证 apply3ANoiseWorklet接口执行时机比publish 接口早。

53037

LOAD_3A_MODULE_FAILED

加载 3A 降噪模块失败。

排查建议：请稍后重试。若重试多次，仍无法解决问题，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

CallLib 状态码

10000

SUCCESS

成功。

53200

STATE_MACHINE_EXIT

存在未结束的状态机。

排查建议：请检查上次通话是否结束，您可按需调用 hungup 方法挂断当前通话，再重新建立新的通话。

53201

SEND_MSG_ERROR

发送 IM 消息失败。

排查建议：发送 IM 消息失败。可根据控制台输出的 IMLib 状态码查询具体原因。

53202

REJECTED_BY_BLACKLIST

被对方加入黑名单。

排查建议：可根据业务需求将用户移出黑名单，请参阅移除黑名单中用户。

53203

NOT_IN_GROUP

当前用户不再群组中。

排查建议：

1. 请检查用户是否在群组中，可通过融云控制台 > 北极星 > Server Api 调试群组模块进行查询，加入等动作。
2. 如果用户在群组中，但服务端仍返回该错误，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，群组ID，问题发生时间等。

53301

GET_LOCAL_AUDIO_TRACK_ERROR

获得本地音频流失败。

排查建议：获得本地音频流失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53302

GET_LOCAL_VIDEO_TRACK_ERROR

获得本地视频流失败。

排查建议：获得本地视频流失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53303

GET_LOCAL_AUDIO_AND_VIDEO_TRACK_ERROR

获得本地音视频流失败。

排查建议：获得本地音视频流失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53304

JOIN_ROOM_ERROR

加入房间失败。

排查建议：加入房间失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53305

AUDIO_PUBLISH_ERROR

发布音频失败。

排查建议：发布音频失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53306

VIDEO_PUBLISH_ERROR

发布视频失败。

排查建议：发布视频失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53307

AUDIO_AND_VIDEO_PUBLISH_ERROR

发布音视频失败。

排查建议：发布音视频失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53308

QUERY_JOINED_USER_INFO_ERROR

查询房间用户信息失败。

排查建议：查询房间用户信息失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53309

MISSING_VIDEO_TRACK_ERROR

禁用启用视频时，房间内缺少视频流。

排查建议：本地无采集到 track，请提交工单与我们联系，并附上必要的的信息，如 App key，用户 ID，问题发生时间等。

53310

UNPUBLISH_VIDEO_ERROR

取消发布视频失败。

排查建议：取消发布视频失败。可根据控制台输出的 RTCLib 状态码查询具体原因。

53311

CONVERSATION_NOT_GROUP_ERROR

会话不是群组。

排查建议：

1. 请检查发起多人呼叫时传入的 targetId 是否为有效的群组 id。
2. 请检查用户是否在群组中，可通过融云控制台 > 北极星 > Server Api 调试群组模块进行查询，加入等动作。