tencent cloud

文档反馈

错误码

最后更新时间: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 网络状况不佳:上行带宽太小,上传数据受阻
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持