tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
实时音视频
    文档
    Download PDF

    错误码表

    最后更新时间：2024-10-25 17:21:43
    下载PDF
      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
      当前是观众角色，不能请求或断开跨房连麦，需要先 switchRole 到主播
      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
      音视频发送时间戳异常，可能引起音画不同步问题
      联系我们

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

      联系我们
      技术支持

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

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款