tencent cloud

Feedback

Error Codes

Last updated: 2024-08-22 15:24:50
    Copyright (c) 2021 Tencent. All rights reserved.
    
    Module: TRTC ErrorCode
    
    Function: Used to notify customers of warnings and errors that occur during the use of TRTC
    
    ErrorCode

    EnumType

    EnumType
    DESC
    Error Codes
    Warning codes

    TXLiteAVError

    TXLiteAVError

    Error Codes

    Enum
    Value
    DESC
    ERR_NULL
    0
    No error.
    ERR_FAILED
    -1
    Unclassified error.
    ERR_INVALID_PARAMETER
    -2
    An invalid parameter was passed in when the API was called.
    ERR_REFUSED
    -3
    The API call was rejected.
    ERR_NOT_SUPPORTED
    -4
    The current API cannot be called.
    ERR_INVALID_LICENSE
    -5
    Failed to call the API because the license is invalid.
    ERR_REQUEST_SERVER_TIMEOUT
    -6
    The request timed out.
    ERR_SERVER_PROCESS_FAILED
    -7
    The server cannot process your request.
    ERR_DISCONNECTED
    -8
    Disconnected from the server.
    ERR_CAMERA_START_FAIL
    -1301
    Failed to turn the camera on. This may occur when there is a problem with the camera configuration program (driver) on Windows or macOS. Disable and reenable the camera, restart the camera, or update the configuration program.
    ERR_CAMERA_NOT_AUTHORIZED
    -1314
    No permission to access to the camera. This usually occurs on mobile devices and may be because the user denied access.
    ERR_CAMERA_SET_PARAM_FAIL
    -1315
    Incorrect camera parameter settings (unsupported values or others).
    ERR_CAMERA_OCCUPY
    -1316
    The camera is being used. Try another camera.
    ERR_SCREEN_CAPTURE_START_FAIL
    -1308
    Failed to start screen recording. If this occurs on a mobile device, it may be because the user denied screen sharing permission; if it occurs on Windows or macOS, check whether the parameters of the screen recording API are set as required.
    ERR_SCREEN_CAPTURE_UNSURPORT
    -1309
    Screen recording failed. Screen recording is only supported on Android versions later than 5.0 and iOS versions later than 11.0.
    ERR_SCREEN_CAPTURE_STOPPED
    -7001
    Screen recording was stopped by the system.
    ERR_SCREEN_SHARE_NOT_AUTHORIZED
    -102015
    No permission to publish the substream.
    ERR_SCREEN_SHRAE_OCCUPIED_BY_OTHER
    -102016
    Another user is publishing the substream.
    ERR_VIDEO_ENCODE_FAIL
    -1303
    Failed to encode video frames. This may occur when a user on iOS switches to another app, which may cause the system to release the hardware encoder. When the user switches back, this error may be thrown before the hardware encoder is restarted.
    ERR_UNSUPPORTED_RESOLUTION
    -1305
    Unsupported video resolution.
    ERR_PIXEL_FORMAT_UNSUPPORTED
    -1327
    Custom video capturing: Unsupported pixel format.
    ERR_BUFFER_TYPE_UNSUPPORTED
    -1328
    Custom video capturing: Unsupported buffer type.
    ERR_NO_AVAILABLE_HEVC_DECODERS
    -2304
    No available HEVC decoder found.
    ERR_MIC_START_FAIL
    -1302
    Failed to turn the mic on. This may occur when there is a problem with the mic configuration program (driver) on Windows or macOS. Disable and reenable the mic, restart the mic, or update the configuration program.
    ERR_MIC_NOT_AUTHORIZED
    -1317
    No permission to access to the mic. This usually occurs on mobile devices and may be because the user denied access.
    ERR_MIC_SET_PARAM_FAIL
    -1318
    Failed to set mic parameters.
    ERR_MIC_OCCUPY
    -1319
    The mic is being used. The mic cannot be turned on when, for example, the user is having a call on the mobile device.
    ERR_MIC_STOP_FAIL
    -1320
    Failed to turn the mic off.
    ERR_SPEAKER_START_FAIL
    -1321
    Failed to turn the speaker on. This may occur when there is a problem with the speaker configuration program (driver) on Windows or macOS. Disable and reenable the speaker, restart the speaker, or update the configuration program.
    ERR_SPEAKER_SET_PARAM_FAIL
    -1322
    Failed to set speaker parameters.
    ERR_SPEAKER_STOP_FAIL
    -1323
    Failed to turn the speaker off.
    ERR_AUDIO_PLUGIN_START_FAIL
    -1330
    Failed to record computer audio, which may be because the audio driver is unavailable.
    ERR_AUDIO_PLUGIN_INSTALL_NOT_AUTHORIZED
    -1331
    No permission to install the audio driver.
    ERR_AUDIO_PLUGIN_INSTALL_FAILED
    -1332
    Failed to install the audio driver.
    ERR_AUDIO_PLUGIN_INSTALLED_BUT_NEED_RESTART
    -1333
    The virtual sound card is installed successfully, but due to the restrictions of macOS, you cannot use it right after installation. Ask users to restart the app upon receiving this error code.
    ERR_AUDIO_ENCODE_FAIL
    -1304
    Failed to encode audio frames. This may occur if the SDK could not process the custom audio data passed in.
    ERR_UNSUPPORTED_SAMPLERATE
    -1306
    Unsupported audio sample rate.
    ERR_TRTC_ENTER_ROOM_FAILED
    -3301
    Failed to enter the room. For the reason, refer to the error message for -3301 in onError .
    ERR_TRTC_REQUEST_IP_TIMEOUT
    -3307
    IP and signature request timed out. Check your network connection and whether your firewall allows UDP.
    Try visiting the IP address 162.14.22.165:8000 or 162.14.6.105:8000 and the domain default-query.trtc.tencent-cloud.com:8000.
    ERR_TRTC_CONNECT_SERVER_TIMEOUT
    -3308
    Room entry request timed out. Check your network connection and whether VPN is used. You can also switch to 4G to run a test.
    ERR_TRTC_ROOM_PARAM_NULL
    -3316
    Empty room entry parameters. Please check whether valid parameters were passed in to the enterRoom:appScene: API.
    ERR_TRTC_INVALID_SDK_APPID
    -3317
    Incorrect room entry parameter. Check whether TRTCParams.sdkAppId is empty.
    ERR_TRTC_INVALID_ROOM_ID
    -3318
    Incorrect room entry parameter. Check whether TRTCParams.roomId or TRTCParams.strRoomId is empty. Note that you cannot set both parameters.
    ERR_TRTC_INVALID_USER_ID
    -3319
    Incorrect room entry parameter. Check whether TRTCParams.userId is empty.
    ERR_TRTC_INVALID_USER_SIG
    -3320
    Incorrect room entry parameter. Check whether TRTCParams.userSig is empty.
    ERR_TRTC_ENTER_ROOM_REFUSED
    -3340
    Request to enter room denied. Check whether you called enterRoom twice to enter the same room.
    ERR_TRTC_INVALID_PRIVATE_MAPKEY
    -100006
    Advanced permission control is enabled but failed to verify TRTCParams.privateMapKey .
    For details, see Enabling Advanced Permission Control.
    ERR_TRTC_SERVICE_SUSPENDED
    -100013
    The service is unavailable. Check if you have used up your package or whether your Tencent Cloud account has overdue payments.
    ERR_TRTC_USER_SIG_CHECK_FAILED
    -100018
    Failed to verify UserSig . Check whether TRTCParams.userSig is correct or valid.
    For details, see UserSig Generation and Verification.
    ERR_TRTC_PUSH_THIRD_PARTY_CLOUD_TIMEOUT
    -3321
    The relay to CDN request timed out
    ERR_TRTC_MIX_TRANSCODING_TIMEOUT
    -3322
    The On-Cloud MixTranscoding request timed out.
    ERR_TRTC_PUSH_THIRD_PARTY_CLOUD_FAILED
    -3323
    Abnormal response packets for relay.
    ERR_TRTC_MIX_TRANSCODING_FAILED
    -3324
    Abnormal response packet for On-Cloud MixTranscoding.
    ERR_TRTC_START_PUBLISHING_TIMEOUT
    -3333
    Signaling for publishing to the Tencent Cloud CDN timed out.
    ERR_TRTC_START_PUBLISHING_FAILED
    -3334
    Signaling for publishing to the Tencent Cloud CDN was abnormal.
    ERR_TRTC_STOP_PUBLISHING_TIMEOUT
    -3335
    Signaling for stopping publishing to the Tencent Cloud CDN timed out.
    ERR_TRTC_STOP_PUBLISHING_FAILED
    -3336
    Signaling for stopping publishing to the Tencent Cloud CDN was abnormal.
    ERR_TRTC_CONNECT_OTHER_ROOM_TIMEOUT
    -3326
    The co-anchoring request timed out.
    ERR_TRTC_DISCONNECT_OTHER_ROOM_TIMEOUT
    -3327
    The request to stop co-anchoring timed out.
    ERR_TRTC_CONNECT_OTHER_ROOM_INVALID_PARAMETER
    -3328
    Invalid parameter.
    ERR_TRTC_CONNECT_OTHER_ROOM_AS_AUDIENCE
    -3330
    The current user is an audience member and cannot request or stop cross-room communication. Please call switchRole to switch to an anchor first.
    ERR_BGM_OPEN_FAILED
    -4001
    Failed to open the file, such as invalid data found when processing input, ffmpeg protocol not found, etc.
    ERR_BGM_DECODE_FAILED
    -4002
    Audio file decoding failed.
    ERR_BGM_OVER_LIMIT
    -4003
    The number exceeds the limit, such as preloading two background music at the same time.
    ERR_BGM_INVALID_OPERATION
    -4004
    Invalid operation, such as calling a preload function after starting playback.
    ERR_BGM_INVALID_PATH
    -4005
    Invalid path, Please check whether the path you passed points to a legal music file.
    ERR_BGM_INVALID_URL
    -4006
    Invalid URL, Please use a browser to check whether the URL address you passed in can download the desired music file.
    ERR_BGM_NO_AUDIO_STREAM
    -4007
    No audio stream, Please confirm whether the file you passed is a legal audio file and whether the file is damaged.
    ERR_BGM_FORMAT_NOT_SUPPORTED
    -4008
    Unsupported format, Please confirm whether the file format you passed is a supported file format. The mobile version supports [mp3, aac, m4a, wav, ogg, mp4, mkv], and the desktop version supports [mp3, aac, m4a, wav, mp4, mkv].

    TXLiteAVWarning

    TXLiteAVWarning

    Warning codes

    Enum
    Value
    DESC
    WARNING_HW_ENCODER_START_FAIL
    1103
    Failed to start the hardware encoder. Switched to software encoding.
    WARNING_CURRENT_ENCODE_TYPE_CHANGED
    1104
    The codec changed.
    The additional field type in onWarning indicates the codec currently in use. 0 indicates H.264, and 1 indicates H.265.
    The additional field hardware in onWarning indicates the encoder type currently in use. 0 indicates software encoder, and 1 indicates hardware encoder.
    The additional field stream in onWarning indicates the stream type currently in use. 0 indicates big stream, and 1 indicates small stream, and 2 indicates sub stream.
    WARNING_VIDEO_ENCODER_SW_TO_HW
    1107
    Insufficient CPU for software encoding. Switched to hardware encoding.
    WARNING_INSUFFICIENT_CAPTURE_FPS
    1108
    The capturing frame rate of the camera is insufficient. This error occurs on some Android phones with built-in beauty filters.
    WARNING_SW_ENCODER_START_FAIL
    1109
    Failed to start the software encoder.
    WARNING_REDUCE_CAPTURE_RESOLUTION
    1110
    The capturing frame rate of the camera was reduced for balance between frame rate and performance.
    WARNING_CAMERA_DEVICE_EMPTY
    1111
    No available camera found.
    WARNING_CAMERA_NOT_AUTHORIZED
    1112
    The user didn’t grant the application camera permission.
    WARNING_OUT_OF_MEMORY
    1113
    Some functions may not work properly due to out of memory.
    WARNING_CAMERA_IS_OCCUPIED
    1114
    The camera is occupied.
    WARNING_CAMERA_DEVICE_ERROR
    1115
    The camera device is error.
    WARNING_CAMERA_DISCONNECTED
    1116
    The camera is disconnected.
    WARNING_CAMERA_START_FAILED
    1117
    The camera is started failed.
    WARNING_CAMERA_SERVER_DIED
    1118
    The camera sever is died.
    WARNING_SCREEN_CAPTURE_NOT_AUTHORIZED
    1206
    The user didn’t grant the application screen recording permission.
    WARNING_CURRENT_DECODE_TYPE_CHANGED
    2008
    The codec changed. The additional field type in onWarning indicates the codec currently in use. 1 indicates H.265, and 0 indicates H.264. This field is not supported on Windows.
    WARNING_VIDEO_FRAME_DECODE_FAIL
    2101
    Failed to decode the current video frame.
    WARNING_HW_DECODER_START_FAIL
    2106
    Failed to start the hardware decoder. The software decoder is used instead.
    WARNING_VIDEO_DECODER_HW_TO_SW
    2108
    The hardware decoder failed to decode the first I-frame of the current stream. The SDK automatically switched to the software decoder.
    WARNING_SW_DECODER_START_FAIL
    2109
    Failed to start the software decoder.
    WARNING_VIDEO_RENDER_FAIL
    2110
    Failed to render the video.
    WARNING_VIRTUAL_BACKGROUND_DEVICE_UNSURPORTED
    8001
    The device does not support virtual background
    WARNING_VIRTUAL_BACKGROUND_NOT_AUTHORIZED
    8002
    Virtual background not authorized
    WARNING_VIRTUAL_BACKGROUND_INVALID_PARAMETER
    8003
    Enable virtual background with invalid parameter
    WARNING_VIRTUAL_BACKGROUND_PERFORMANCE_INSUFFICIENT
    8004
    Virtual background performance insufficient
    WARNING_MICROPHONE_DEVICE_EMPTY
    1201
    No available mic found.
    WARNING_SPEAKER_DEVICE_EMPTY
    1202
    No available speaker found.
    WARNING_MICROPHONE_NOT_AUTHORIZED
    1203
    The user didn’t grant the application mic permission.
    WARNING_MICROPHONE_DEVICE_ABNORMAL
    1204
    The audio capturing device is unavailable (which may be because the device is used by another application or is considered invalid by the system).
    WARNING_SPEAKER_DEVICE_ABNORMAL
    1205
    The audio playback device is unavailable (which may be because the device is used by another application or is considered invalid by the system).
    WARNING_BLUETOOTH_DEVICE_CONNECT_FAIL
    1207
    The bluetooth device failed to connect (which may be because another app is occupying the audio channel by setting communication mode).
    WARNING_MICROPHONE_IS_OCCUPIED
    1208
    The audio capturing device is occupied.
    WARNING_AUDIO_FRAME_DECODE_FAIL
    2102
    Failed to decode the current audio frame.
    WARNING_AUDIO_RECORDING_WRITE_FAIL
    7001
    Failed to write recorded audio into the file.
    WARNING_MICROPHONE_HOWLING_DETECTED
    7002
    Detect capture audio howling
    WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE
    6001
    The current user is an audience member and cannot publish audio or video. Please switch to an anchor first.
    WARNING_UPSTREAM_AUDIO_AND_VIDEO_OUT_OF_SYNC
    6006
    The audio or video sending timestamps are abnormal, which may cause audio and video synchronization issues.
    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support