腾讯云实时音视频错误码表_音视频解决方案_同尘科技
Copyright (c) 2021 Tencent. All rights reserved.
Module: TRTC 错误码表
Function: 用于通知客户 TRTC 在使用过程中出现的警告和错误
错误码表
枚举类型
| 枚举类型 | 描述 |
| TXLiteAVError | 错误码 |
| TXLiteAVWarning | 警告码 |
TXLiteAVError
TXLiteAVError
错误码
| 枚举 | 取值 | 描述 |
| ERR_NULL | 0 | 无错误 |
| ERR_FAILED | -1 | 暂未归类的通用错误 |
| ERR_INVALID_PARAMETER | -2 | 调用 API 时，传入的参数不合法 |
| ERR_REFUSED | -3 | API 调用被拒绝 |
| ERR_NOT_SUPPORTED | -4 | 当前 API 不支持调用 |
| ERR_INVALID_LICENSE | -5 | license 不合法，调用失败 |
| ERR_REQUEST_SERVER_TIMEOUT | -6 | 请求服务器超时 |
| ERR_SERVER_PROCESS_FAILED | -7 | 服务器无法处理您的请求 |
| ERR_DISCONNECTED | -8 | 断开连接 |
| ERR_CAMERA_START_FAIL | -1301 | 打开摄像头失败，例如在 Windows 或 Mac 设备，摄像头的配置程序（驱动程序）异常，禁用后重新启用设备，或者重启机器，或者更新配置程序 |
| ERR_CAMERA_NOT_AUTHORIZED | -1314 | 摄像头设备未授权，通常在移动设备出现，可能是权限被用户拒绝了 |
| ERR_CAMERA_SET_PARAM_FAIL | -1315 | 摄像头参数设置出错（参数不支持或其它） |
| ERR_CAMERA_OCCUPY | -1316 | 摄像头正在被占用中，可尝试打开其他摄像头 |
| ERR_SCREEN_CAPTURE_START_FAIL | -1308 | 开始录屏失败，如果在移动设备出现，可能是权限被用户拒绝了，如果在 Windows 或 Mac 系统的设备出现，请检查录屏接口的参数是否符合要求 |
| ERR_SCREEN_CAPTURE_UNSURPORT | -1309 | 录屏失败，在 Android 平台，需要5.0以上的系统，在 iOS 平台，需要11.0以上的系统 |
| ERR_SCREEN_CAPTURE_STOPPED | -7001 | 录屏被系统中止 |
| ERR_SCREEN_SHARE_NOT_AUTHORIZED | -102015 | 没有权限上行辅路 |
| ERR_SCREEN_SHRAE_OCCUPIED_BY_OTHER | -102016 | 其他用户正在上行辅路 |
| ERR_VIDEO_ENCODE_FAIL | -1303 | 视频帧编码失败，例如 iOS 设备切换到其他应用时，硬编码器可能被系统释放，再切换回来时，硬编码器重启前，可能会抛出 |
| ERR_UNSUPPORTED_RESOLUTION | -1305 | 不支持的视频分辨率 |
| ERR_PIXEL_FORMAT_UNSUPPORTED | -1327 | 自定视频采集：设置的 pixel format 不支持 |
| ERR_BUFFER_TYPE_UNSUPPORTED | -1328 | 自定视频采集：设置的 buffer type 不支持 |
| ERR_NO_AVAILABLE_HEVC_DECODERS | -2304 | 找不到可用的 HEVC 解码器 |
| 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 | 停止扬声器失败 |
| ERR_AUDIO_PLUGIN_START_FAIL | -1330 | 开启系统声音录制失败，例如音频驱动插件不可用 |
| ERR_AUDIO_PLUGIN_INSTALL_NOT_AUTHORIZED | -1331 | 安装音频驱动插件未授权 |
| ERR_AUDIO_PLUGIN_INSTALL_FAILED | -1332 | 安装音频驱动插件失败 |
| ERR_AUDIO_PLUGIN_INSTALLED_BUT_NEED_RESTART | -1333 | 安装虚拟声卡插件成功，但首次安装后功能暂时不可用，此为 Mac 系统限制，请在收到此错误码后提示用户重启当前 APP |
| ERR_AUDIO_ENCODE_FAIL | -1304 | 音频帧编码失败，例如传入自定义音频数据，SDK 无法处理 |
| ERR_UNSUPPORTED_SAMPLERATE | -1306 | 不支持的音频采样率 |
| ERR_TRTC_ENTER_ROOM_FAILED | -3301 | 进入房间失败，请查看 onError 中的 -3301 对应的 msg 提示确认失败原因 |
| ERR_TRTC_REQUEST_IP_TIMEOUT | -3307 | 请求 IP 和 sig 超时，请检查网络是否正常，或网络防火墙是否放行 UDP。可尝试访问下列 IP：162.14.22.165:8000 162.14.6.105:8000 和域名：default-query.trtc.tencent-cloud.com:8000 |
| ERR_TRTC_CONNECT_SERVER_TIMEOUT | -3308 | 请求进房超时，请检查是否断网或者是否开启vpn，您也可以切换4G进行测试确认 |
| ERR_TRTC_ROOM_PARAM_NULL | -3316 | 进房参数为空，请检查： enterRoom:appScene: 接口调用是否传入有效的 param |
| ERR_TRTC_INVALID_SDK_APPID | -3317 | 进房参数 sdkAppId 错误，请检查 TRTCParams.sdkAppId 是否为空 |
| ERR_TRTC_INVALID_ROOM_ID | -3318 | 进房参数 roomId 错误，请检查 TRTCParams.roomId 或 TRTCParams.strRoomId 是否为空，注意 roomId 和 strRoomId 不可混用 |
| ERR_TRTC_INVALID_USER_ID | -3319 | 进房参数 userId 不正确，请检查 TRTCParams.userId 是否为空 |
| ERR_TRTC_INVALID_USER_SIG | -3320 | 进房参数 userSig 不正确，请检查 TRTCParams.userSig 是否为空 |
| ERR_TRTC_ENTER_ROOM_REFUSED | -3340 | 进房请求被拒绝，请检查是否连续调用 enterRoom 进入相同 Id 的房间 |
| ERR_TRTC_INVALID_PRIVATE_MAPKEY | -100006 | 您开启了高级权限控制，但参数 TRTCParams.privateMapKey 校验失败，您可参考 高级权限控制 进行检查 |
| ERR_TRTC_SERVICE_SUSPENDED | -100013 | 服务不可用。请检查：套餐包剩余分钟数是否大于0，腾讯云账号是否欠费。您可参考 套餐包管理 进行查看与配置 |
| ERR_TRTC_USER_SIG_CHECK_FAILED | -100018 | UserSig 校验失败，请检查参数 TRTCParams.userSig 是否填写正确，或是否已经过期。您可参考 UserSig 生成与校验 进行校验 |
| ERR_TRTC_PUSH_THIRD_PARTY_CLOUD_TIMEOUT | -3321 | 旁路转推请求超时 |
| ERR_TRTC_MIX_TRANSCODING_TIMEOUT | -3322 | 云端混流请求超时 |
| ERR_TRTC_PUSH_THIRD_PARTY_CLOUD_FAILED | -3323 | 旁路转推回包异常 |
| ERR_TRTC_MIX_TRANSCODING_FAILED | -3324 | 云端混流回包异常 |
| ERR_TRTC_START_PUBLISHING_TIMEOUT | -3333 | 开始向腾讯云的直播 CDN 推流信令超时 |
| ERR_TRTC_START_PUBLISHING_FAILED | -3334 | 开始向腾讯云的直播 CDN 推流信令异常 |
| ERR_TRTC_STOP_PUBLISHING_TIMEOUT | -3335 | 停止向腾讯云的直播 CDN 推流信令超时 |
| ERR_TRTC_STOP_PUBLISHING_FAILED | -3336 | 停止向腾讯云的直播 CDN 推流信令异常 |
| ERR_TRTC_CONNECT_OTHER_ROOM_TIMEOUT | -3326 | 请求连麦超时 |
| ERR_TRTC_DISCONNECT_OTHER_ROOM_TIMEOUT | -3327 | 请求退出连麦超时 |
| ERR_TRTC_CONNECT_OTHER_ROOM_INVALID_PARAMETER | -3328 | 无效参数 |
| ERR_TRTC_CONNECT_OTHER_ROOM_AS_AUDIENCE | -3330 | 当前是观众角色，不能请求或断开跨房连麦，需要先 switchRole 到主播 |
| ERR_BGM_OPEN_FAILED | -4001 | 打开音频文件失败 |
| ERR_BGM_DECODE_FAILED | -4002 | 音频文件解码失败 |
| ERR_BGM_OVER_LIMIT | -4003 | 数量超过限定值，如同时预加载两首背景音乐 |
| ERR_BGM_INVALID_OPERATION | -4004 | 无效操作，如开始播放后再调用预加载操作 |
TXLiteAVWarning
TXLiteAVWarning
警告码
| 枚举 | 取值 | 描述 |
| WARNING_HW_ENCODER_START_FAIL | 1103 | 硬编码启动出现问题，自动切换到软编码 |
| WARNING_CURRENT_ENCODE_TYPE_CHANGED | 1104 | 表示编码器发生改变，可以通过 onWarning 函数的扩展信息中的 type 字段来获取当前的编码格式。其中 1 代表 265 编码，0 代表 264 编码。注意 Windows 端不支持此错误码的扩展信息。 |
| 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_OUT_OF_MEMORY | 1113 | 内存不足，部分功能可能不正常。 |
| WARNING_SCREEN_CAPTURE_NOT_AUTHORIZED | 1206 | 用户未授权当前应用使用屏幕录制 |
| WARNING_CURRENT_DECODE_TYPE_CHANGED | 2008 | 表示解码器发生改变，可以通过 onWarning 函数的扩展信息中的 type 字段来获取当前的解码格式。其中 1 代表 265 解码，0 代表 264 解码。注意 Windows 端不支持此错误码的扩展信息。 |
| WARNING_VIDEO_FRAME_DECODE_FAIL | 2101 | 当前视频帧解码失败 |
| 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_MICROPHONE_DEVICE_EMPTY | 1201 | 没有检测到可用的麦克风设备 |
| WARNING_SPEAKER_DEVICE_EMPTY | 1202 | 没有检测到可用的扬声器设备 |
| WARNING_MICROPHONE_NOT_AUTHORIZED | 1203 | 用户未授权当前应用使用麦克风 |
| WARNING_MICROPHONE_DEVICE_ABNORMAL | 1204 | 音频采集设备不可用（例如被占用或者PC判定无效设备） |
| WARNING_SPEAKER_DEVICE_ABNORMAL | 1205 | 音频播放设备不可用（例如被占用或者PC判定无效设备） |
| WARNING_BLUETOOTH_DEVICE_CONNECT_FAIL | 1207 | 蓝牙设备连接失败（例如其他应用通过设置通话音量占用音频通道） |
| WARNING_MICROPHONE_IS_OCCUPIED | 1208 | 音频采集设备被占用 |
| WARNING_AUDIO_FRAME_DECODE_FAIL | 2102 | 当前音频帧解码失败 |
| WARNING_AUDIO_RECORDING_WRITE_FAIL | 7001 | 音频录制写入文件失败 |
| WARNING_MICROPHONE_HOWLING_DETECTED | 7002 | 录制音频时监测到啸叫 |
| WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE | 6001 | 当前是观众角色，不支持发布音视频，需要先切换成主播角色 |
| WARNING_UPSTREAM_AUDIO_AND_VIDEO_OUT_OF_SYNC | 6006 | 音视频发送时间戳异常，可能引起音画不同步问题 |
对音视频的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
- 0人点赞 -
相关推荐
腾讯云实时互动教育版产品动态_音视频解决方案_同尘科技
腾讯云多人音视频房间SDK多人音视频房间 SDK 2.0版本发布和推荐升级公告_音视频解决方案_同尘科技
腾讯云多人音视频房间SDKSDK2.0版本升级指引_音视频解决方案_同尘科技
暂无评论，你要说点什么吗？