tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Real-Time Communication
    Documentation
    Download PDF

    Error Codes

    Last updated: 2024-10-25 17:25:16
    Download PDF
      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. 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. Encoder exception caused encoding failure.
      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_SYSTEM_LOOPBACK_START_FAILED
      -1307
      System audio loopback startup encountered an error. Common error reasons and solutions are: 1. The current system version does not support the include or excluded specified process loopback function, which requires Windows system version 10.0.19042 (20H2) or higher. For x64 specified path loopback function, it also requires Windows system version 10.0.19042 (20H2) or higher. Please check the current system version. 2. Invalid input parameters (including empty parameters, non-existent input paths, non-existent process IDs, and non-existent device names). Please check whether the input parameters are legal. 3. No available speaker device, please check whether it is available.
      ERR_SYSTEM_LOOPBACK_THIRD_PARTY_APP_EXIT
      -1324
      The third party app loopback capture encountered an error. This error occurred after the third party app loopback was successfully started. During the sound collection process, the specified process or application unexpectedly exited. Please check the status of the specified process or application and try again by re-entering the process number
      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.

      Contact Us
      Technical Support

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

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy