错误码

最近更新时间:2020-08-28 12:35:24

错误码表

基础错误码

符号 含义
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_SERVICE_SUSPENDED -100013 服务不可用。请检查:套餐包剩余分钟数是否大于0,腾讯云账号是否欠费

退房相关错误码

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_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 网络状况不佳:上行带宽太小,上传数据受阻
目录