tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Real-Time Communication
    Documentation
    Download PDF

    Error Codes

    Last updated: 2023-10-09 11:53:42
    Download PDF

      Error Codes

      Basic error codes

      Code
      Value
      Description
      ERR_NULL
      0
      No error.

      Error codes for room entry

      TRTCCloud.enterRoom() will trigger this type of error code if room entry fails. You can use the callback functions TRTCCloudDelegate.onEnterRoom() and TRTCCloudDelegate.OnError() to capture related notifications.
      Code
      Value
      Description
      ERR_ROOM_ENTER_FAIL
      -3301
      Failed to enter room.
      ERR_ENTER_ROOM_PARAM_NULL
      -3316
      Empty room entry parameters. Please check whether valid parameters are passed in the TRTCCloud.enterRoom(): API when it is called.
      ERR_SDK_APPID_INVALID
      -3317
      Invalid sdkAppId.
      ERR_ROOM_ID_INVALID
      -3318
      Invalid roomId.
      ERR_USER_ID_INVALID
      -3319
      Invalid userID.
      ERR_USER_SIG_INVALID
      -3320
      Invalid userSig.
      ERR_ROOM_REQUEST_ENTER_ROOM_TIMEOUT
      -3308
      Room entry request timed out. Please check your network.
      ERR_SERVER_INFO_PRIVILEGE_FLAG_ERROR
      -100006
      Failed to verify the permission ticket. Please check whether privateMapKey is correct.
      ERR_SERVER_INFO_SERVICE_SUSPENDED
      -100013
      Service unavailable. Please check whether there are remaining minutes in your packages and whether your Tencent Cloud account has overdue payment.
      ERR_SERVER_INFO_ECDH_GET_TINYID
      -100018
      userSig verification failed. Please check whether userSig is correct.

      Error code for room exit

      TRTCCloud.exitRoom() triggers this error code if room exit fails. You can use the callback function TRTCCloudDelegate.OnError() to capture related notifications.
      Code
      Value
      Description
      ERR_ROOM_REQUEST_QUIT_ROOM_TIMEOUT
      -3325
      Room exit request timed out.

      Error codes for devices (camera, mic, and speaker)

      You can use the callback function TRTCCloudDelegate.OnError() to capture related notifications.
      Code
      Value
      Description
      ERR_CAMERA_START_FAIL
      -1301
      Failed to turn camera on. This error may occur when there is a problem with the camera configuration program (driver) on Windows or macOS. In this case, disable and reenable the camera, restart the camera, or update the configuration program.
      ERR_CAMERA_NOT_AUTHORIZED
      -1314
      Camera not authorized. This error usually occurs on mobile devices and may be because users denied camera permission.
      ERR_CAMERA_SET_PARAM_FAIL
      -1315
      Failed to set camera parameters (unsupported values or others).
      ERR_CAMERA_OCCUPY
      -1316
      Camera occupied. Try using another camera.
      ERR_MIC_START_FAIL
      -1302
      Failed to turn mic on. This error may occur when there is a problem with the mic configuration program (driver) on Windows or macOS. In this case, disable and reenable the mic, restart the mic, or update the configuration program.
      ERR_MIC_NOT_AUTHORIZED
      -1317
      Mic not authorized. This error usually occurs on mobile devices and may be because users denied mic permission.
      ERR_MIC_SET_PARAM_FAIL
      -1318
      Failed to set mic parameters.
      ERR_MIC_OCCUPY
      -1319
      Mic already in use. This error may occur when the user is currently in a call on the mobile device, in which case TRTC will fail to turn the mic on.
      ERR_MIC_STOP_FAIL
      -1320
      Failed to turn mic off.
      ERR_SPEAKER_START_FAIL
      -1321
      Failed to turn speaker on. This error may occur when there is a problem with the speaker configuration program (driver) on Windows or macOS. In this case, 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 speaker off.

      Error codes for screen sharing

      You can use the callback function TRTCCloudDelegate.OnError() to capture related notifications.
      Code
      Value
      Description
      ERR_SCREEN_CAPTURE_START_FAIL
      -1308
      Failed to start screen recording. If this error occurs on a mobile device, it may be because users denied screen recording 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. If you use Android, make sure its version is 5.0 or later; if you use iOS, make sure its version is 11.0 or later.
      ERR_SERVER_CENTER_NO_PRIVILEDGE_PUSH_SUB_VIDEO
      -102015
      No permission to send substream video images.
      ERR_SERVER_CENTER_ANOTHER_USER_PUSH_SUB_VIDEO
      -102016
      Another user is sending substream video images.
      ERR_SCREEN_CAPTURE_STOPPED
      -7001
      Screen recording stopped by the system.

      Error codes for encoding and decoding

      You can use the callback function TRTCCloudDelegate.OnError() to capture related notifications.
      Code
      Value
      Description
      ERR_VIDEO_ENCODE_FAIL
      -1303
      Failed to encode video frames. This error 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.
      PUSH_ERR_UNSUPPORTED_RESOLUTION
      -1305
      Unsupported video resolution.
      ERR_AUDIO_ENCODE_FAIL
      -1304
      Failed to encode audio frames. This error may occur when the SDK could not process the custom audio data passed in.
      PUSH_ERR_UNSUPPORTED_SAMPLERATE
      -1306
      Unsupported audio sample rate.

      Error codes for custom capturing

      You can use the callback function TRTCCloudDelegate.OnError() to capture related notifications.
      Code
      Value
      Description
      ERR_PIXEL_FORMAT_UNSUPPORTED
      -1327
      Unsupported pixel format.
      ERR_BUFFER_TYPE_UNSUPPORTED
      -1328
      Unsupported buffer type.

      Error codes for CDN binding and stream mixing

      You can use the callback functions TRTCCloudDelegate.onStartPublishing() and TRTCCloudDelegate.onSetMixTranscodingConfig() to capture related notifications.
      Code
      Value
      Description
      ERR_PUBLISH_CDN_STREAM_REQUEST_TIME_OUT
      -3321
      Relay-to-CDN request timed out.
      ERR_CLOUD_MIX_TRANSCODING_REQUEST_TIME_OUT
      -3322
      On-Cloud MixTranscoding request timed out.
      ERR_PUBLISH_CDN_STREAM_SERVER_FAILED
      -3323
      Abnormal response packets for relay.
      ERR_CLOUD_MIX_TRANSCODING_SERVER_FAILED
      -3324
      Abnormal response packets for On-Cloud MixTranscoding.
      ERR_ROOM_REQUEST_START_PUBLISHING_TIMEOUT
      -3333
      Signaling of starting to push to Tencent Cloud’s live streaming CDN timed out.
      ERR_ROOM_REQUEST_START_PUBLISHING_ERROR
      -3334
      Abnormal signaling of starting to push to Tencent Cloud’s live streaming CDN.
      ERR_ROOM_REQUEST_STOP_PUBLISHING_TIMEOUT
      -3335
      Signaling of stopping pushing to Tencent Cloud’s live streaming CDN timed out.
      ERR_ROOM_REQUEST_STOP_PUBLISHING_ERROR
      -3336
      Abnormal signaling of stopping pushing to Tencent Cloud’s live streaming CDN.

      Error codes for cross-room communication

      TRTCCloud.ConnectOtherRoom() will trigger this type of error code if cross-room co-anchoring fails. You can use the callback function TRTCCloudDelegate.onConnectOtherRoom() to capture related notifications.
      Code
      Value
      Description
      ERR_ROOM_REQUEST_CONN_ROOM_TIMEOUT
      -3326
      Cross-room communication request timed out.
      ERR_ROOM_REQUEST_DISCONN_ROOM_TIMEOUT
      -3327
      Request to end cross-room communication timed out.
      ERR_ROOM_REQUEST_CONN_ROOM_INVALID_PARAM
      -3328
      Invalid parameter.
      ERR_CONNECT_OTHER_ROOM_AS_AUDIENCE
      -3330
      You are an audience member and cannot initiate or end cross-room communication. You need to switch to the anchor role using switchRole().
      ERR_SERVER_CENTER_CONN_ROOM_NOT_SUPPORT
      -102031
      Cross-room communication not supported.
      ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_NUM
      -102032
      Reached the maximum number of cross-room calls.
      ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_RETRY_TIMES
      -102033
      Reached the maximum number of retries for cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_REQ_TIMEOUT
      -102034
      Cross-room communication request timed out.
      ERR_SERVER_CENTER_CONN_ROOM_REQ
      -102035
      Cross-room communication request format is incorrect.
      ERR_SERVER_CENTER_CONN_ROOM_NO_SIG
      -102036
      No signature for cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_DECRYPT_SIG
      -102037
      Failed to decrypt signature for cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_NO_KEY
      -102038
      Decryption key for cross-room communication signature not found.
      ERR_SERVER_CENTER_CONN_ROOM_PARSE_SIG
      -102039
      Signature parsing error for cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_INVALID_SIG_TIME
      -102040
      Incorrect timestamp of cross-room communication signature.
      ERR_SERVER_CENTER_CONN_ROOM_SIG_GROUPID
      -102041
      Mismatch of room ID in cross-room communication signature.
      ERR_SERVER_CENTER_CONN_ROOM_NOT_CONNED
      -102042
      Mismatch of username in cross-room communication signature.
      ERR_SERVER_CENTER_CONN_ROOM_USER_NOT_CONNED
      -102043
      The user did not initiate cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_FAILED
      -102044
      Failed to start cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_CANCEL_FAILED
      -102045
      Failed to cancel cross-room communication.
      ERR_SERVER_CENTER_CONN_ROOM_CONNED_ROOM_NOT_EXIST
      -102046
      The room being connected for cross-room communication does not exist.
      ERR_SERVER_CENTER_CONN_ROOM_CONNED_REACH_MAX_ROOM
      -102047
      The room being connected reached the maximum number of cross-room calls.
      ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_NOT_EXIST
      -102048
      The user being called for cross-room communication does not exist.
      ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_DELETED
      -102049
      The user being called for cross-room communication was deleted.
      ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_FULL
      -102050
      All resources of the user being called for cross-room communication are occupied.
      ERR_SERVER_CENTER_CONN_ROOM_INVALID_SEQ
      -102051
      Sequence number for cross-room communication not in sequential order.

      Warning Codes

      Warning codes do not require your special attention. You can choose whether to prompt the user depending on the situation.
      Code
      Value
      Description
      WARNING_HW_ENCODER_START_FAIL
      1103
      Failed to start hardware encoder. The SDK automatically switched to software encoder.
      WARNING_VIDEO_ENCODER_SW_TO_HW
      1107
      Insufficient CPU for software encoder. The SDK automatically switched to hardware encoder.
      WARNING_INSUFFICIENT_CAPTURE_FPS
      1108
      Insufficient frame rate of video captured by camera. This error may occur on Android devices with built-in beauty filter algorithms.
      WARNING_SW_ENCODER_START_FAIL
      1109
      Failed to start software encoder.
      WARNING_REDUCE_CAPTURE_RESOLUTION
      1110
      Camera resolution reduced for balance between frame rate and performance.
      WARNING_CAMERA_DEVICE_EMPTY
      1111
      No available camera found.
      WARNING_CAMERA_NOT_AUTHORIZED
      1112
      User did not grant the application camera access.
      WARNING_MICROPHONE_DEVICE_EMPTY
      1201
      No available mic found.
      WARNING_SPEAKER_DEVICE_EMPTY
      1202
      No available speaker found.
      WARNING_MICROPHONE_NOT_AUTHORIZED
      1203
      User did not grant the application mic access.
      WARNING_MICROPHONE_DEVICE_ABNORMAL
      1204
      No audio capturing device available (for example, because the device is occupied).
      WARNING_SPEAKER_DEVICE_ABNORMAL
      1205
      No audio playback device available (for example, because the device is occupied).
      WARNING_VIDEO_FRAME_DECODE_FAIL
      2101
      Failed to decode current video frame.
      WARNING_AUDIO_FRAME_DECODE_FAIL
      2102
      Failed to decode current audio frame.
      WARNING_VIDEO_PLAY_LAG
      2105
      Video playback stuttering.
      WARNING_HW_DECODER_START_FAIL
      2106
      Failed to start hardware decoder. Software decoder is used instead.
      WARNING_VIDEO_DECODER_HW_TO_SW
      2108
      Hardware decoder failed to decode first I-frame of current stream. The SDK automatically switched to software decoder.
      WARNING_SW_DECODER_START_FAIL
      2109
      Failed to start software decoder.
      WARNING_VIDEO_RENDER_FAIL
      2110
      Failed to render video.
      WARNING_START_CAPTURE_IGNORED
      4000
      Video capturing already started. Request ignored.
      WARNING_AUDIO_RECORDING_WRITE_FAIL
      7001
      Failed to write recorded audio to file.
      WARNING_ROOM_DISCONNECT
      5101
      Network disconnected.
      WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE
      6001
      You are in the role of audience. The request to send audio/video data is ignored.
      WARNING_NET_BUSY
      1101
      Bad network connection: Data upload blocked due to limited upstream bandwidth.
      WARNING_RTMP_SERVER_RECONNECT
      1102
      Push error. The network is disconnected. Reconnecting… (max attempts: 3).
      WARNING_LIVE_STREAM_SERVER_RECONNECT
      2103
      Pull error. The network is disconnected. Reconnecting… (max attempts: 3).
      WARNING_RECV_DATA_LAG
      2104
      Unstable incoming packets. This may be caused by insufficient downstream bandwidth or unstable streams from the anchor.
      WARNING_RTMP_DNS_FAIL
      3001
      Live streaming error. DNS resolution failed.
      WARNING_RTMP_SEVER_CONN_FAIL
      3002
      Live streaming error. Failed to connect to server.
      WARNING_RTMP_SHAKE_FAIL
      3003
      Live streaming error. Handshake with RTMP server failed.
      WARNING_RTMP_SERVER_BREAK_CONNECT
      3004
      Live streaming error. Connection dropped by server.
      WARNING_RTMP_READ_WRITE_FAIL
      3005
      Live streaming error. RTMP read/write failed. Disconnecting.
      WARNING_RTMP_WRITE_FAIL
      3006
      Live streaming error. RTMP write failed. This is an internal error code of the SDK and is not thrown.
      WARNING_RTMP_READ_FAIL
      3007
      Live streaming error. RTMP read failed. This is an internal error code of the SDK and is not thrown.
      WARNING_RTMP_NO_DATA
      3008
      Live streaming error. Server disconnected as no data is sent for over 30 seconds.
      WARNING_PLAY_LIVE_STREAM_INFO_CONNECT_FAIL
      3009
      Live streaming error. Failed to call connect to connect to server. This is an internal error code of the SDK and is not thrown.
      WARNING_NO_STEAM_SOURCE_FAIL
      3010
      Live streaming error. Connection failed as there was no video in the stream address. This is an internal error code of the SDK and is not thrown.
      WARNING_ROOM_RECONNECT
      5102
      Network disconnected. Reconnecting…
      WARNING_ROOM_NET_BUSY
      5103
      Bad network connection: Data upload blocked due to limited upstream bandwidth.
      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