Error Codes
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. |
- 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 screen sharing
- 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