tencent cloud

Feedback

Error Codes

Last updated: 2022-09-26 15:46:41

    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 communication 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 communication connections.
    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 co-anchoring.
    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 communication connections.
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_NOT_EXIST
    -102048
    The user being called for co-anchoring does not exist.
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_DELETED
    -102049
    The user being called for co-anchoring was deleted.
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_FULL
    -102050
    All resources of the user being called for co-anchoring 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.

    Technical Support

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

    7x24 Phone Support