实时音视频 SPARKRTC-客户端错误码

时间：2024-10-24 09:45:21

实时音视频 SPARKRTC 接口参考

客户端错误码

本章节介绍了SDK的客户端错误码HRTCErrorCode的详细信息。

当SDK运行出现网络、媒体相关等错误时，SDK无法自动恢复，需要App干预或进行用户提示。

枚举	错误码	描述	错误原因
HRTC_ERR_CODE_SUC CES S	0	成功	-
HRTC_ERR_CODE_SDK_INTERNAL_ERROR	90000001	SDK内部系统错误	SDK内部异常。
HRTC_ERR_CODE_MSG_TOOLARGE	90000002	发送的消息太大	发送消息时，消息体太大。
HRTC_ERR_CODE_MEM_NOT_ENOUGH	90000003	内存不足	内存申请不到。
HRTC_ERR_CODE_SYNSEND_MSG_ERR	90000004	消息发送失败	消息队列异常，导致内部消息发送失败。
HRTC_ERR_CODE_PA RAM _ERROR	90000005	参数错误	包括如下两方面：接口入参无效。内部参数错误。
HRTC_ERR_CODE_API_CALLED_IN_WRONG_ORDER	90000006	API接口调用顺序不当	当前只有日志设置必须在初始化之前。
HRTC_ERR_CODE_SETUP_LOCAL_VIEW_FAIL	90000007	设置本地窗口失败	该错误码仅Android平台返回。
HRTC_ERR_CODE_START_REMOTE_STREAM_VIEW_FAIL	90000008	设置远端窗口失败	publisher场景没有远端画面，不应该设置；用户不存在；处于离会中等。
HRTC_ERR_CODE_SET_DEVICE_FAIL	90000009	设置设备失败	设置播放、录音、视频设备失败。
HRTC_ERR_CODE_INITIALIZING	90000010	初始化过程中	初始化过程中，不能再做初始化或者去初始化操作。
HRTC_ERR_CODE_UN_INITIALIZING	90000011	去初始化过程中	去初始化过程中，不能再做初始化或者去初始化操作。
HRTC_ERR_CODE_ LOG _UPLOADING	90000012	日志正在上传	日志正在上传过程中。
HRTC_ERR_CODE_MEDIA_PORT_ERROR	90000013	媒体端口获取失败	音频从10010开始，视频从10020开始，尝试10次，端口都被占用了。
HRTC_ERR_CODE_WATCH_VIEW_TOO_MUCH	90000014	视频选看超过规格	当前支持最多设置16个设置远端窗口，若超过，则会失败。
HRTC_ERR_CODE_MEDIA_CMP_ERR	90000015	媒体协商失败	与服务器之间媒体协商失败。
HRTC_ERR_CODE_SERVER_NO_RESPONSE	90000016	服务器没有响应	选看在2-4s内没有收到服务器的响应。
HRTC_ERR_CODE_USER_ROLE_CHANGE_FAIL	90000017	角色切换失败	角色切换失败。
HRTC_ERR_CODE_JOIN_ROOM_FAIL	90000018	加入房间失败	加入房间失败。
HRTC_ERR_CODE_JOIN_ROOM_STATUS_BUSY	90000019	加入房间失败	已在房间中或正在网络探测中。
HRTC_ERR_CODE_JOIN_ROOM_SERVER_ERROR	90000020	加入房间失败	加入房间失败，服务器异常。
HRTC_ERR_CODE_JOIN_ROOM_SERVICE_UNREACHABLE	90000021	加入房间失败	加入房间失败，服务不可达。
HRTC_ERR_CODE_JOIN_ROOM_AUTH_FAIL	90000022	加入房间失败	加入房间失败，鉴权失败。
HRTC_ERR_CODE_JOIN_ROOM_AUTH_RETRY	90000023	加入房间失败	加入房间失败，鉴权重试。
HRTC_ERR_CODE_JOIN_ROOM_CLOCK_SYNC	90000024	加入房间失败	加入房间失败，时钟同步。
HRTC_ERR_CODE_JOIN_ROOM_URL_NOT_RIGHT	90000025	加入房间失败	加入房间失败，url错误。
HRTC_ERR_CODE_KICKED_OFF	90000026	被踢出房间	相同用户ID等原因，被踢出房间。
HRTC_ERR_CODE_SCREEN_CAPTURE_FAIL	90000027	共享失败	房间内已经存在辅流等原因，导致共享失败。
HRTC_ERR_CODE_EXT_MEDIA_OUTPUT	90000028	设置输出设备错误	当开启媒体数据输出时，不允许设置输出设备，否则会报此异常。
HRTC_ERR_CODE_RECONNECT_FAILED	90000029	连接异常	重连失败。
HRTC_ERR_CODE_SERVER_BREAK_DOWN	90000030	服务器异常	服务器宕机。
HRTC_ERR_CODE_SIGNATURE_EXPIRED	90000031	签名过期	签名已过期。
HRTC_ERR_CODE_SET_REMOTE_RENDER_MODE_FAIL	90000032	设置视图模式失败	设置远端窗口模式失败。
HRTC_ERR_CODE_SET_REMOTE_AUDIO_MUTE_FAIL	90000033	设置远端音频接收失败	订阅或取消订阅音频失败。
HRTC_ERR_CODE_SET_USEROLE_NOT_ALLOWED	90000036	跨房后，不允许在本房间内做角色切换	跨房后，不允许在本房间内做角色切换，通过onError返回。
HRTC_ERR_CODE_EXT_MEDIA_CAPTURE_INPUT	90000037	当前为第三方采集模式，禁用该操作	开启第三方采集模式后，禁用部分操作。
HRTC_ERR_CODE_SET_EXTAUDIO_CAPTURE_FAIL	90000038	设置第三方音频采集失败	设置第三方音频采集失败。
HRTC_ERR_CODE_SET_EXTVIDEO_CAPTURE_FAIL	90000039	设置第三方视频采集失败	设置第三方视频采集失败。
HRTC_ERR_CODE_SET_SHARE_COMPUTER_SOUND_FAIL	90000040	设置共享声音开关失败	设置共享声音开关失败。
HRTC_ERR_CODE_SET_LOCAL_AUDIO_MUTE_FAIL	90000041	启停上行音频流失败	启停上行音频流失败。
HRTC_ERR_CODE_SET_LOCAL_VIDEO_MUTE_FAIL	90000042	启停上行视频流失败	启停上行视频流失败。
HRTC_ERR_CODE_USER_REMOVED	90000043	用户被移除	用户被移除。
HRTC_ERR_CODE_ROOM_DISMISSED	90000044	房间被解散	房间被解散。
HRTC_ERR_CODE_SETUP_REMOTE_VIEW_FAIL	90000045	设置远端View失败	设置远端View失败。
HRTC_ERR_CODE_REGION_NOT_COVERED	90000048	区域未覆盖	所在区域不能提供SparkRTC服务。
HRTC_ERR_CODE_SET_EXTDATA_CAPTURE_FAIL	90000049	设置第三方辅流采集失败	设置第三方辅流采集失败
HRTC_ERR_CODE_NOT_SUPPORT	90000050	该平台不支持此功能	该平台不支持此功能
HRTC_ERR_CODE_AUDIO_ROUTE_HANDLER_NOT_INIT	90000051	音频路由没有初始化	音频路由没有初始化
HRTC_ERR_CODE_AUDIO_ROUTE_PLUGIN_CONNECTED	90000052	音频路由外设连接	音频路由外设连接
HRTC_ERR_CODE_AUDIO_ROUTE_NO_NEED_CHANGE	90000053	音频设置路由和当前路由相同	音频设置路由和当前路由相同
HRTC_ERR_CODE_AUDIO_ROUTE_CHANGE_ERROR	90000054	音频路由切换失败	音频路由切换失败
HRTC_ERR_CODE_AUDIO_ROUTE_CLOSED	90000055	音频路由控制开关关闭，无法切换路由	音频路由控制开关关闭，无法切换路由
HRTC_ERR_CODE_LOCAL_AUDIO_DISABLE_FAIL	90000056	当前未推音频流	当前未推音频流
HRTC_ERR_CODE_ROLE_NOT_SUPPORT	90000057	当前角色不支持该操作	当前角色不支持该操作
HRTC_ERR_CODE_ENABLE_BACKGROUND_FAIL	90000058	没有动态加载ML图像分割库，不能支持背景虚化和背景替换能力	没有动态加载ML图像分割库，不能支持背景虚化和背景替换能力
HRTC_ERR_CODE_ENABLE_BACKGROUND_FAIL	90000059	背景虚化或背景替换开启失败	背景虚化或背景替换开启失败
HRTC_ERR_CODE_COMMAND_REMOTEUSER_FAIL	90000060	发送CMD时，目标用户不存在	发送CMD时，目标用户不存在
HRTC_ERR_CODE_COMMAND_NOTENABLED	90000061	CMD没有被启用	CMD没有被启用
HRTC_ERR_CODE_MSG_TOOQUICK	90000062	发送的消息太频繁	发送的消息太频繁
HRTC_ERR_CODE_MSG_API_CALL_UNREASONABLE	90000063	API调用不合理	API调用不合理
HRTC_ERR_CODE_VIDEO_BAD_STATE	90000064	模块状态错误	模块状态错误
HRTC_ERR_CODE_AUDIO_SHARE_FAIL	90000065	声音共享失败	声音共享失败