tencent cloud

文档反馈

错误码表

最后更新时间:2024-01-16 09:21:24
    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
    视频帧编码失败,例如 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
    音视频发送时间戳异常,可能引起音画不同步问题
    联系我们

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

    技术支持

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

    7x24 电话支持