Error Codes

Focus Mode

Font Size

Last updated: 2025-04-16 17:32:39

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 occurs when, for example, there is a problem with the camera configuration program (driver) on Windows or macOS. In this case, turn the camera off and on again, 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 occurs when, for example, there is a problem with the mic configuration program (driver) on Windows or macOS. In this case, turn the mic off and on again, 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 occupied. This error occurs when, for example, the user is 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 occurs when, for example, there is a problem with the speaker configuration program (driver) on Windows or macOS. In this case, turn the speaker off and on again, 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 occurs when, for example, 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 occurs when, for example, 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.

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

Tencent Real-Time Communication

Error Codes

Error Codes

Basic error codes

Error codes for room entry

Error code for room exit

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

Error codes for encoding and decoding

Error codes for custom capturing

Error codes for CDN binding and stream mixing

Error codes for cross-room communication

Warning Codes

Help and Support

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.