Copyright (c) 2021 Tencent. All rights reserved.
Module: TRTC 错误码表
Function: 用于通知客户 TRTC 在使用过程中出现的警告和错误
错误码表
枚举类型
| 枚举类型 |
描述 |
| 错误码 |
|
| 警告码 |
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 |
视频帧编码失败，编码器异常导致编码失败 |
| 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_SYSTEM_LOOPBACK_START_FAILED |
-1307 |
系统混音启动出错，常见的出错原因及解决：1.当前系统版本无法支持，指定、排除指定进程混音功能需满足 Windows 系统为10.0.19042（20H2）或更高版本，指定路径混音功能 x64 版本需满足 Windows 系统为10.0.19042（20H2）或更高版本，请检查当前系统版本。2.传入参数非法（包括参数为空、传入路径不存在、传入进程号不存在、传入设备名不存在），请检查传入参数是否合法。3.无可用扬声器设备，请检查是否可用 |
| ERR_SYSTEM_LOOPBACK_THIRD_PARTY_APP_EXIT |
-1324 |
第三方应用混音采集出错，该错误可能出现于第三方应用混音启动成功后，在采集声音的过程中指定进程或应用意外退出，请检查指定进程或应用的状态，可通过重新输入进程号进行重试 |
| 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 |
当前是观众角色，不能请求或断开跨房连麦，需要先 |
| ERR_BGM_OPEN_FAILED |
-4001 |
打开文件失败，如音频数据无效，FFMPEG 协议未找到等 |
| ERR_BGM_DECODE_FAILED |
-4002 |
音频文件解码失败 |
| ERR_BGM_OVER_LIMIT |
-4003 |
数量超过限定值，如同时预加载两首背景音乐 |
| ERR_BGM_INVALID_OPERATION |
-4004 |
无效操作，如开始播放后再调用预加载操作 |
| ERR_BGM_INVALID_PATH |
-4005 |
非法路径导致打开文件失败，请检查您传入的路径参数是否指向一个合法的音乐文件 |
| ERR_BGM_INVALID_URL |
-4006 |
非法URL导致打开文件失败，请用浏览器检查您传入的 URL 地址是否可以下载到期望的音乐文件 |
| ERR_BGM_NO_AUDIO_STREAM |
-4007 |
无音频流导致打开文件失败，请确认您传入的文件是否是合法的音频文件，以及文件是否被损坏 |
| ERR_BGM_FORMAT_NOT_SUPPORTED |
-4008 |
格式不支持导致打开文件失败，请确认您传入的文件格式是否是支持的文件格式，移动端支持【mp3，aac，m4a，wav，ogg，mp4，mkv】，桌面端支持 【mp3，aac，m4a，wav，mp4，mkv】 |
TXLiteAVWarning
TXLiteAVWarning
警告码
| 枚举 |
取值 |
描述 |
| WARNING_HW_ENCODER_START_FAIL |
1103 |
硬编码启动出现问题，自动切换到软编码 |
| WARNING_CURRENT_ENCODE_TYPE_CHANGED |
1104 |
表示编码器发生改变，可以通过 onWarning 函数的扩展信息中的相关字段来获取当前的编码格式和类型。 type 字段值为 0 代表 H.264 编码，1 代表 H.265 编码 hardware 字段值为 0 代表软件编码，1 代表硬件编码 stream 字段值为 0 代表大流，1 代表小流，2 代表辅流 |
| 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_CAMERA_IS_OCCUPIED |
1114 |
摄像头被占用. |
| WARNING_CAMERA_DEVICE_ERROR |
1115 |
摄像头设备异常. |
| WARNING_CAMERA_DISCONNECTED |
1116 |
摄像头无法连接. |
| WARNING_CAMERA_START_FAILED |
1117 |
摄像头启动失败. |
| WARNING_CAMERA_SERVER_DIED |
1118 |
系统异常. |
| 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_VIRTUAL_BACKGROUND_DEVICE_UNSURPORTED |
8001 |
虚拟背景设备不支持 |
| WARNING_VIRTUAL_BACKGROUND_NOT_AUTHORIZED |
8002 |
虚拟背景未授权 |
| WARNING_VIRTUAL_BACKGROUND_INVALID_PARAMETER |
8003 |
虚拟背景参数异常 |
| WARNING_VIRTUAL_BACKGROUND_PERFORMANCE_INSUFFICIENT |
8004 |
虚拟背景性能不足 |
| 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 |
音视频发送时间戳异常，可能引起音画不同步问题 |