- 最新动态
- 服务公告
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
-
客户端SDK参考
- 使用前必读
- SDK概述
- 隐私声明
- 合规使用指南
- Android SDK
- iOS/macOS SDK
- All Platform C++ SDK
- Web SDK
- 接入鉴权
- 附录
- 修订记录
-
常见问题
-
产品咨询
- SparkRTC支持哪些平台?
- SparkRTC Demo怎么体验?
- 在进行Windows的Demo使用或集成SDK时,提示微软C++标准库缺失,该如何获取?
- SparkRTC支持接入微信小程序吗?
- 实时音视频是什么?
- 实时音视频和直播有什么区别?
- SparkRTC是否支持在国外使用?
- SparkRTC RoomID是什么?取值区间值是多少?
- SparkRTC最多可以同时创建多少个房间?
- SparkRTC UserID是什么?取值范围是多少?
- 怎么理解SparkRTC的角色Role?
- SparkRTC最多可以支持多少个人同时视频通话?
- 实时音视频的时延是多少?
- SparkRTC是否支持连麦互动?
- SparkRTC是否支持双向的桌面推送?
- 实时音视频支持私有化部署吗?
- PC端实时音视频支持USB摄像头吗?
- 计费购买
- Signature相关
- 录制相关
-
SDK使用
- 移动端(Android/iOS)创建一个房间,是否支持PC端(MAC/Windows)接入?
- iOS平台如何缩减安装包体积?
- Android平台如何缩减安装包体积?
- iOS端是否可以监听远端离开房间?
- 背景音乐是否支持循环播放?
- SparkRTC是否支持调整背景音乐的播放进度?
- 支持监听房间成员进出房间吗?
- 如何监测断网和重连?
- 支持首帧渲染回调吗?能否监听画面开始渲染?
- 如何设置上行视频码率、分辨率和帧率?
- 有没有推荐的画面质量(码率、分辨率、帧率)相关参数配置?
- 如何实现横屏视频通话?
- 是否支持网络测速?如何操作?
- 是否支持音量大小提示?
- 自定义渲染支持哪些格式?
- SparkRTC支持iOS后台运行吗?
- 移动端如何实现录屏(屏幕分享)?
- 多人视频会议中,移动端和Web端可以进入同一房间吗?
- SparkRTC的Web端、移动端、PC端是不是同步的?
- Android SDK是否支持自定义采集数据?
- SparkRTC支持旁路推流吗?
- Windows端如何才能采集到被分享应用播放的声音?
- SDK是否支持断线重连机制?
- 如何创建房间?
- 两台手机同时运行SparkRTC APP,为什么无法互通?
- 鉴权是如何生成的?在什么时候生成?
- onVideoStats、onAudioStatus、onSubStreamStats回调触发时为什么程序会崩溃?
- 为什么本端听筒能听到自己的声音?
- setExternalAudioCapture(音频自采集)、setExternalVideoCapture(视频自采集)、setExternalMediaFrameOutput(视频自渲染)能在进入房间后开启吗?
- SparkRTC是否支持设置镜像画面?
- SparkRTC音视频过程中的上下行码率、分辨率、丢包率、音频采样率等信息怎么获取?
- SparkRTC是否支持设置本地采集音量?是否支持设置每个远端用户的播放音量?
- enableLocalVideo和muteLocalVideo有什么区别?
- enableLocalAudioStream和muteLocalAudio有什么区别?
- SparkRTC是否支持对房间进行权限校验?
- 接入PC端是否支持屏幕分享功能?
- SparkRTC是否支持将本地视频文件分享到实时音视频中?
- SparkRTC是否支持单纯的实时音频?
- 一个房间里可以同时有多路屏幕分享吗?
- SparkRTC是否支持1080P?
- 是否支持视频画面截图功能?
- 播放背景音乐是否支持在线音乐?
- 同一个页面中,可以创建N个RTC对象,通过N个UserID,分别登录到N个房间吗?
- Web端用宽高设置的推流分辨率适用于所有浏览器吗?
- Web端SDK在使用过程中拔掉摄像头,摄像头列表里面的数据如何清除?
- Web端SDK可以获取当前音量大小吗?
- Web端支持监听远端离开房间吗?
- Web端通话过程中为什么会出现回声、杂音、噪声、声音小?
- Web端如何切换摄像头和麦克风?
- SparkRTC支持白板功能吗?
- 相同UserID支持同时进入多个房间吗?
- SparkRTC房间的生命周期是多久?
- SparkRTC多人视频通话支持蓝牙耳机吗?
- SparkRTC多人视频通话支持仅订阅2/3/4人音频吗?
- 指定窗口分享,当窗口大小变化时,视频流的分辨率会跟着变化吗?
- 视频通话支持悬浮窗、大小画面切换功能吗?
- 发送自定义消息接口能实现聊天室、弹幕等功能吗?
- 支持查询所有的UserID吗?
- Web SDK中的checkSystemRequirements接口为什么会调用异常?
- 问题排查
-
产品咨询
- 文档下载
- 通用参考
展开导读
链接复制成功!
客户端错误码
本章节介绍了SDK的客户端错误码HRTCErrorCode的详细信息。
当SDK运行出现网络、媒体相关等错误时,SDK无法自动恢复,需要App干预或进行用户提示。
枚举 |
错误码 |
描述 |
错误原因 |
---|---|---|---|
HRTC_ERR_CODE_SUCCESS |
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_PARAM_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 |
声音共享失败 |
声音共享失败 |