tencent cloud

实时音视频

动态与公告
产品动态
产品近期公告
关于 TRTC Live 正式上线的公告
关于TRTC Conference 正式版上线的公告
Conference 商业化版本即将推出
关于多人音视频 Conference 开启内测公告
关于音视频通话 Call 正式版上线的公告
关于腾讯云音视频终端 SDK 播放升级及新增授权校验的公告
关于 TRTC 应用订阅套餐服务上线的相关说明
产品简介
产品概述
基本概念
产品功能
产品优势
应用场景
性能数据
购买指南
计费概述
免费时长说明
月订阅
现收现付
TRTC 逾期与暂停政策
常见问题解答
退款说明
新手指引
Demo 体验
视频通话 SDK
组件介绍
开通服务
跑通 Demo
快速接入
离线唤醒
会话聊天
云端录制
AI 降噪
界面定制
Chat 集成通话能力
更多特性
无 UI 集成
服务端 API
客户端 API
解决方案
错误码表
发布日志
常见问题
视频会议 SDK
组件介绍(TUIRoomKit)
开通服务(TUIRoomKit)
跑通 Demo(TUIRoomKit)
快速接入(TUIRoomKit)
屏幕共享(TUIRoomKit)
预定会议(TUIRoomKit)
会中呼叫(TUIRoomKit)
界面定制(TUIRoomKit)
虚拟背景(TUIRoomKit)
会议控制(TUIRoomKit)
云端录制(TUIRoomKit)
AI 降噪(TUIRoomKit)
会中聊天(TUIRoomKit)
机器人推流(TUIRoomKit)
更多特性(TUIRoomKit)
客户端 API(TUIRoomKit)
服务端 API(TUIRoomKit)
常见问题(TUIRoomKit)
错误码 (TUIRoomKit)
SDK更新日志(TUIRoomKit)
直播与语聊 SDK
Live 视频直播计费说明
组件介绍
开通服务(TUILiveKit)
跑通 Demo
无 UI 集成
UI 自定义
直播监播
视频直播
语聊房
高级功能
客户端 API
服务端 API
错误码
发布日志
常见问题
RTC Engine
开通服务
SDK 下载
API-Example
接入指引
API-参考手册
高级功能
AI 集成
概述
MCP 配置
Skills 配置
集成指南
常见问题
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
控制台指南
应用管理
套餐包管理
用量统计
监控仪表盘
开发辅助
解决方案
实时合唱
常见问题
迁移指南
计费相关
功能相关
UserSig 相关
应对防火墙限制相关
缩减安装包体积相关
Andriod 与 iOS 相关
Web 端相关
Flutter 相关
Electron 相关
TRTCCalling Web 相关
音视频质量相关
其他问题
旧版文档
RTC RoomEngine SDK(旧)
集成 TUIRoom (Web)
集成 TUIRoom (Android)
集成 TUIRoom (iOS)
集成 TUIRoom (Flutter)
集成 TUIRoom (Electron)
TUIRoom API 查询
实现云端录制与回放(旧)
监控仪表盘计费(旧)
协议与策略
安全合规认证
安全白皮书
信息安全说明
服务等级协议
苹果隐私策略:PrivacyInfo.xcprivacy
TRTC 政策
隐私协议
数据处理和安全协议
词汇表

错误码

PDF
聚焦模式
字号
最后更新时间: 2022-06-15 09:40:45

错误码表

基础错误码

符号
含义
ERR_NULL
0
无错误

进房相关错误码

TRTCCloud.enterRoom() 在进房失败时会触发此类错误码,您可以通过回调函数 TRTCCloudDelegate.onEnterRoom() 和 TRTCCloudDelegate.OnError() 捕获相关通知。
符号
含义
ERR_ROOM_ENTER_FAIL
-3301
进入房间失败
ERR_ENTER_ROOM_PARAM_NULL
-3316
进房参数为空,请检查 TRTCCloud.enterRoom(): 接口调用是否传入有效的 param
ERR_SDK_APPID_INVALID
-3317
进房参数 sdkAppId 错误
ERR_ROOM_ID_INVALID
-3318
进房参数 roomId 错误
ERR_USER_ID_INVALID
-3319
进房参数 userID 不正确
ERR_USER_SIG_INVALID
-3320
进房参数 userSig 不正确
ERR_ROOM_REQUEST_ENTER_ROOM_TIMEOUT
-3308
请求进房超时,请检查网络
ERR_SERVER_INFO_PRIVILEGE_FLAG_ERROR
-100006
权限位校验失败,请检查 privateMapKey 是否正确
ERR_SERVER_INFO_SERVICE_SUSPENDED
-100013
服务不可用。请检查:套餐包剩余分钟数是否大于0,腾讯云账号是否欠费
ERR_SERVER_INFO_ECDH_GET_TINYID
-100018
userSig 校验失败,请检查 userSig 是否正确

退房相关错误码

TRTCCloud.exitRoom() 在退房失败时会触发此类错误码,您可以通过回调函数 TRTCCloudDelegate.OnError() 捕获相关通知。
符号
含义
ERR_ROOM_REQUEST_QUIT_ROOM_TIMEOUT
-3325
请求退房超时

设备(摄像头、麦克风、扬声器)相关错误码

您可以通过回调函数 TRTCCloudDelegate.OnError() 捕获相关通知。
符号
含义
ERR_CAMERA_START_FAIL
-1301
打开摄像头失败,例如在 Windows 或 Mac 设备,摄像头的配置程序(驱动程序)异常,禁用后重新启用设备,或者重启机器,或者更新配置程序
ERR_CAMERA_NOT_AUTHORIZED
-1314
摄像头设备未授权,通常在移动设备出现,可能是权限被用户拒绝了
ERR_CAMERA_SET_PARAM_FAIL
-1315
摄像头参数设置出错(参数不支持或其它)
ERR_CAMERA_OCCUPY
-1316
摄像头正在被占用中,可尝试打开其他摄像头
ERR_MIC_START_FAIL
-1302
打开麦克风失败,例如在 Windows 或 Mac 设备,麦克风的配置程序(驱动程序)异常,禁用后重新启用设备,或者重启机器,或者更新配置程序
ERR_MIC_NOT_AUTHORIZED
-1317
麦克风设备未授权,通常在移动设备出现,可能是权限被用户拒绝了
ERR_MIC_SET_PARAM_FAIL
-1318
麦克风设置参数失败
ERR_MIC_OCCUPY
-1319
麦克风正在被占用中,例如移动设备正在通话时,打开麦克风会失败
ERR_MIC_STOP_FAIL
-1320
停止麦克风失败
ERR_SPEAKER_START_FAIL
-1321
打开扬声器失败,例如在 Windows 或 Mac 设备,扬声器的配置程序(驱动程序)异常,禁用后重新启用设备,或者重启机器,或者更新配置程序
ERR_SPEAKER_SET_PARAM_FAIL
-1322
扬声器设置参数失败
ERR_SPEAKER_STOP_FAIL
-1323
停止扬声器失败

屏幕分享相关错误码

您可以通过回调函数 TRTCCloudDelegate.OnError() 捕获相关通知。
符号
含义
ERR_SCREEN_CAPTURE_START_FAIL
-1308
开始录屏失败,如果在移动设备出现,可能是权限被用户拒绝了,如果在 Windows 或 Mac 系统的设备出现,请检查录屏接口的参数是否符合要求
ERR_SCREEN_CAPTURE_UNSURPORT
-1309
录屏失败,在 Android 平台,需要5.0以上的系统,在 iOS 平台,需要11.0以上的系统
ERR_SERVER_CENTER_NO_PRIVILEDGE_PUSH_SUB_VIDEO
-102015
没有权限上行辅路
ERR_SERVER_CENTER_ANOTHER_USER_PUSH_SUB_VIDEO
-102016
其他用户正在上行辅路
ERR_SCREEN_CAPTURE_STOPPED
-7001
录屏被系统中止

编解码相关错误码

您可以通过回调函数 TRTCCloudDelegate.OnError() 捕获相关通知。
符号
含义
ERR_VIDEO_ENCODE_FAIL
-1303
视频帧编码失败,例如 iOS 设备切换到其他应用时,硬编码器可能被系统释放,再切换回来时,硬编码器重启前,可能会抛出
ERR_UNSUPPORTED_RESOLUTION
-1305
不支持的视频分辨率
ERR_AUDIO_ENCODE_FAIL
-1304
音频帧编码失败,例如传入自定义音频数据,SDK 无法处理
ERR_UNSUPPORTED_SAMPLERATE
-1306
不支持的音频采样率

自定义采集相关错误码

您可以通过回调函数 TRTCCloudDelegate.OnError() 捕获相关通知。
符号
含义
ERR_PIXEL_FORMAT_UNSUPPORTED
-1327
设置的 pixel format 不支持
ERR_BUFFER_TYPE_UNSUPPORTED
-1328
设置的 buffer type 不支持

CDN 绑定和混流相关错误码

您可以通过回调函数 TRTCCloudDelegate.onStartPublishing() 和 TRTCCloudDelegate.onSetMixTranscodingConfig() 捕获相关通知。
符号
含义
ERR_PUBLISH_CDN_STREAM_REQUEST_TIME_OUT
-3321
旁路转推请求超时
ERR_CLOUD_MIX_TRANSCODING_REQUEST_TIME_OUT
-3322
云端混流请求超时
ERR_PUBLISH_CDN_STREAM_SERVER_FAILED
-3323
旁路转推回包异常
ERR_CLOUD_MIX_TRANSCODING_SERVER_FAILED
-3324
云端混流回包异常
ERR_ROOM_REQUEST_START_PUBLISHING_TIMEOUT
-3333
开始向腾讯云的直播 CDN 推流信令超时
ERR_ROOM_REQUEST_START_PUBLISHING_ERROR
-3334
开始向腾讯云的直播 CDN 推流信令异常
ERR_ROOM_REQUEST_STOP_PUBLISHING_TIMEOUT
-3335
停止向腾讯云的直播 CDN 推流信令超时
ERR_ROOM_REQUEST_STOP_PUBLISHING_ERROR
-3336
停止向腾讯云的直播 CDN 推流信令异常

跨房连麦相关错误码

TRTCCloud.ConnectOtherRoom() 在跨房失败时会触发此类错误码,您可以通过回调函数 TRTCCloudDelegate.onConnectOtherRoom() 捕获相关通知。
符号
含义
ERR_ROOM_REQUEST_CONN_ROOM_TIMEOUT
-3326
请求连麦超时
ERR_ROOM_REQUEST_DISCONN_ROOM_TIMEOUT
-3327
请求退出连麦超时
ERR_ROOM_REQUEST_CONN_ROOM_INVALID_PARAM
-3328
无效参数
ERR_CONNECT_OTHER_ROOM_AS_AUDIENCE
-3330
当前是观众角色,不能请求或断开跨房连麦,需要先 switchRole() 到主播
ERR_SERVER_CENTER_CONN_ROOM_NOT_SUPPORT
-102031
不支持跨房间连麦
ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_NUM
-102032
达到跨房间连麦上限
ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_RETRY_TIMES
-102033
跨房间连麦重试次数耗尽
ERR_SERVER_CENTER_CONN_ROOM_REQ_TIMEOUT
-102034
跨房间连麦请求超时
ERR_SERVER_CENTER_CONN_ROOM_REQ
-102035
跨房间连麦请求格式错误
ERR_SERVER_CENTER_CONN_ROOM_NO_SIG
-102036
跨房间连麦无签名
ERR_SERVER_CENTER_CONN_ROOM_DECRYPT_SIG
-102037
跨房间连麦签名解密失败
ERR_SERVER_CENTER_CONN_ROOM_NO_KEY
-102038
未找到跨房间连麦签名解密密钥
ERR_SERVER_CENTER_CONN_ROOM_PARSE_SIG
-102039
跨房间连麦签名解析错误
ERR_SERVER_CENTER_CONN_ROOM_INVALID_SIG_TIME
-102040
跨房间连麦签名时间戳错误
ERR_SERVER_CENTER_CONN_ROOM_SIG_GROUPID
-102041
跨房间连麦签名内房间号不匹配
ERR_SERVER_CENTER_CONN_ROOM_NOT_CONNED
-102042
跨房间连麦签名内用户名不匹配
ERR_SERVER_CENTER_CONN_ROOM_USER_NOT_CONNED
-102043
本用户未发起连麦
ERR_SERVER_CENTER_CONN_ROOM_FAILED
-102044
跨房间连麦失败
ERR_SERVER_CENTER_CONN_ROOM_CANCEL_FAILED
-102045
取消跨房间连麦失败
ERR_SERVER_CENTER_CONN_ROOM_CONNED_ROOM_NOT_EXIST
-102046
被连麦房间不存在
ERR_SERVER_CENTER_CONN_ROOM_CONNED_REACH_MAX_ROOM
-102047
被连麦房间达到连麦上限
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_NOT_EXIST
-102048
被连麦用户不存在
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_DELETED
-102049
被连麦用户已被删除
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_FULL
-102050
被连麦用户达到资源上限
ERR_SERVER_CENTER_CONN_ROOM_INVALID_SEQ
-102051
连麦请求序号错乱

警告码表

警告码无需特别关注,您可以按需选择是否对当前用户进行相应的提示。
符号
含义
WARNING_HW_ENCODER_START_FAIL
1103
硬编码启动出现问题,自动切换到软编码
WARNING_VIDEO_ENCODER_SW_TO_HW
1107
当前 CPU 使用率太高,无法满足软件编码需求,自动切换到硬件编码
WARNING_INSUFFICIENT_CAPTURE_FPS
1108
摄像头采集帧率不足,部分自带美颜算法的 Android 手机上会出现
WARNING_SW_ENCODER_START_FAIL
1109
软编码启动失败
WARNING_REDUCE_CAPTURE_RESOLUTION
1110
摄像头采集分辨率被降低,以满足当前帧率和性能最优解。
WARNING_CAMERA_DEVICE_EMPTY
1111
没有检测到可用的摄像头设备
WARNING_CAMERA_NOT_AUTHORIZED
1112
用户未授权当前应用使用摄像头
WARNING_MICROPHONE_DEVICE_EMPTY
1201
没有检测到可用的麦克风设备
WARNING_SPEAKER_DEVICE_EMPTY
1202
没有检测到可用的扬声器设备
WARNING_MICROPHONE_NOT_AUTHORIZED
1203
用户未授权当前应用使用麦克风
WARNING_MICROPHONE_DEVICE_ABNORMAL
1204
音频采集设备不可用(例如被占用)
WARNING_SPEAKER_DEVICE_ABNORMAL
1205
音频播放设备不可用(例如被占用)
WARNING_VIDEO_FRAME_DECODE_FAIL
2101
当前视频帧解码失败
WARNING_AUDIO_FRAME_DECODE_FAIL
2102
当前音频帧解码失败
WARNING_VIDEO_PLAY_LAG
2105
当前视频播放出现卡顿
WARNING_HW_DECODER_START_FAIL
2106
硬解启动失败,采用软解码
WARNING_VIDEO_DECODER_HW_TO_SW
2108
当前流硬解第一个 I 帧失败,SDK 自动切软解
WARNING_SW_DECODER_START_FAIL
2109
软解码器启动失败
WARNING_VIDEO_RENDER_FAIL
2110
视频渲染失败
WARNING_START_CAPTURE_IGNORED
4000
已经在采集,启动采集被忽略
WARNING_AUDIO_RECORDING_WRITE_FAIL
7001
音频录制写入文件失败
WARNING_ROOM_DISCONNECT
5101
网络断开连接
WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE
6001
当前是观众角色,忽略上行音视频数据
WARNING_NET_BUSY
1101
网络状况不佳:上行带宽太小,上传数据受阻
WARNING_RTMP_SERVER_RECONNECT
1102
直播推流,网络断连, 已启动自动重连(自动重连连续失败超过三次会放弃)
WARNING_LIVE_STREAM_SERVER_RECONNECT
2103
直播拉流,网络断连, 已启动自动重连(自动重连连续失败超过三次会放弃)
WARNING_RECV_DATA_LAG
2104
网络来包不稳:可能是下行带宽不足,或由于主播端出流不均匀
WARNING_RTMP_DNS_FAIL
3001
直播,DNS 解析失败
WARNING_RTMP_SEVER_CONN_FAIL
3002
直播,服务器连接失败
WARNING_RTMP_SHAKE_FAIL
3003
直播,与 RTMP 服务器握手失败
WARNING_RTMP_SERVER_BREAK_CONNECT
3004
直播,服务器主动断开
WARNING_RTMP_READ_WRITE_FAIL
3005
直播,RTMP 读/写失败,将会断开连接
WARNING_RTMP_WRITE_FAIL
3006
直播,RTMP 写失败(SDK 内部错误码,不会对外抛出)
WARNING_RTMP_READ_FAIL
3007
直播,RTMP 读失败(SDK 内部错误码,不会对外抛出)
WARNING_RTMP_NO_DATA
3008
直播,超过30s 没有数据发送,主动断开连接
WARNING_PLAY_LIVE_STREAM_INFO_CONNECT_FAIL
3009
直播,connect 服务器调用失败(SDK 内部错误码,不会对外抛出)
WARNING_NO_STEAM_SOURCE_FAIL
3010
直播,连接失败,该流地址无视频(SDK 内部错误码,不会对外抛出)
WARNING_ROOM_RECONNECT
5102
网络断连,已启动自动重连
WARNING_ROOM_NET_BUSY
5103
网络状况不佳:上行带宽太小,上传数据受阻

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈