Error Codes

Last updated: 2021-07-20 11:02:10

    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 codes if cross-room co-anchoring 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 the room
    ERR_ENTER_ROOM_PARAM_NULL -3316 Empty room entry parameter. Please check whether valid parameters are passed in to the TRTCCloud.enterRoom(): API when it is called
    ERR_SDK_APPID_INVALID -3317 Incorrect room entry parameter sdkAppId
    ERR_ROOM_ID_INVALID -3318 Incorrect room entry parameter roomId
    ERR_USER_ID_INVALID -3319 Incorrect room entry parameter userID
    ERR_USER_SIG_INVALID -3320 Incorrect room entry parameter userSig
    ERR_ROOM_REQUEST_ENTER_ROOM_TIMEOUT -3308 The room entry request timed out. Please check the network
    ERR_SERVER_INFO_SERVICE_SUSPENDED -100013 Unavailable service. Please check whether the remained validity period in minutes in the package is greater than 0 and whether the Tencent Cloud account is in arrears

    Error codes for room exit

    TRTCCloud.exitRoom() will trigger this type of error codes if cross-room co-anchoring fails. You can use the callback function TRTCCloudDelegate.OnError() to capture related notifications.

    Code Value Description
    ERR_ROOM_REQUEST_QUIT_ROOM_TIMEOUT -3325 The 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 enable the camera; for example, the configuration program (driver) of the camera on Windows or macOS was exceptional. In this case, please try to disable and then enable the camera again, restart the device, or update the configuration program
    ERR_CAMERA_NOT_AUTHORIZED -1314 The camera is not authorized. This error usually occurs on mobile devices and may be caused by permission denial by user
    ERR_CAMERA_SET_PARAM_FAIL -1315 Incorrect camera parameter settings (unsupported value or other causes)
    ERR_CAMERA_OCCUPY -1316 The camera is being used. Please try to enable another camera
    ERR_MIC_START_FAIL -1302 Failed to enable the mic; for example, the configuration program (driver) of the mic on Windows or macOS was exceptional. In this case, please try to disable and then enable the mic again, restart the device, or update the configuration program
    ERR_MIC_NOT_AUTHORIZED -1317 The mic is not authorized. This error usually occurs on mobile devices and may be caused by permission denial by user
    ERR_MIC_SET_PARAM_FAIL -1318 Failed to set mic parameters
    ERR_MIC_OCCUPY -1319 The mic is being used. For example, if the mobile device is on a call, the mic will fail to be enabled
    ERR_MIC_STOP_FAIL -1320 Failed to disable the mic
    ERR_SPEAKER_START_FAIL -1321 Failed to enable the speaker; for example, the configuration program (driver) of the speaker on Windows or macOS was exceptional. In this case, please try to disable and then enable the speaker again, restart the device, or update the configuration program
    ERR_SPEAKER_SET_PARAM_FAIL -1322 Failed to set the speaker parameters
    ERR_SPEAKER_STOP_FAIL -1323 Failed to disable the speaker

    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 sharing. If this error occurs on a mobile device, it may be caused by permission denial by user; if on Windows or macOS, please check whether parameters of the screen sharing API meet the requirements
    ERR_SCREEN_CAPTURE_UNSURPORT -1309 Screen sharing failed. Please use Android 5.0 or above if the device is on Android or use iOS 11.0 or above if the device is on iOS
    ERR_SERVER_CENTER_NO_PRIVILEDGE_PUSH_SUB_VIDEO -102015 No permission to upstream substream
    ERR_SERVER_CENTER_ANOTHER_USER_PUSH_SUB_VIDEO -102016 Other users are upstreaming substream
    ERR_SCREEN_CAPTURE_STOPPED -7001 Screencapturing was stopped by the system

    Error code 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; for example, when a user switches from one application to another one on an iOS device, the hardware encoder may be released by the system; and after the user switches back, this error may be thrown before the hardware encoder is restarted
    ERR_UNSUPPORTED_RESOLUTION -1305 Unsupported video resolution
    ERR_AUDIO_ENCODE_FAIL -1304 Failed to encode audio frames; for example, the SDK could not process the custom audio data passed in
    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 mixtranscoding

    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 The relayed push request timed out
    ERR_CLOUD_MIX_TRANSCODING_REQUEST_TIME_OUT -3322 The On-Cloud MixTranscoding request timed out
    ERR_PUBLISH_CDN_STREAM_SERVER_FAILED -3323 The returned packet of relayed push is exceptional
    ERR_CLOUD_MIX_TRANSCODING_SERVER_FAILED -3324 The returned packet of On-Cloud MixTranscoding is exceptional
    ERR_ROOM_REQUEST_START_PUBLISHING_TIMEOUT -3333 Signaling timed out when starting pushing to Tencent Cloud LVB CDN
    ERR_ROOM_REQUEST_START_PUBLISHING_ERROR -3334 Signaling was exceptional when starting pushing to Tencent Cloud LVB CDN
    ERR_ROOM_REQUEST_STOP_PUBLISHING_TIMEOUT -3335 Signaling timed out when stopping pushing to Tencent Cloud LVB CDN
    ERR_ROOM_REQUEST_STOP_PUBLISHING_ERROR -3336 Signaling was exceptional when stopping pushing to Tencent Cloud LVB CDN

    Error codes for cross-room co-anchoring

    TRTCCloud.ConnectOtherRoom() will trigger this type of error codes 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 The co-anchoring request timed out
    ERR_ROOM_REQUEST_DISCONN_ROOM_TIMEOUT -3327 The request for exiting co-anchoring timed out
    ERR_ROOM_REQUEST_CONN_ROOM_INVALID_PARAM -3328 Invalid parameter
    ERR_CONNECT_OTHER_ROOM_AS_AUDIENCE -3330 The current role is viewer, and cross-room co-anchoring cannot be requested or stopped. switchRole() needs to be used to switch the role to anchor first
    ERR_SERVER_CENTER_CONN_ROOM_NOT_SUPPORT -102031 Cross-room co-anchoring unsupported
    ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_NUM -102032 The number of co-anchoring calls has reached the upper limit
    ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_RETRY_TIMES -102033 The number of retries for cross-room co-anchoring has reached the upper limit
    ERR_SERVER_CENTER_CONN_ROOM_REQ_TIMEOUT -102034 The request for cross-room co-anchoring timed out
    ERR_SERVER_CENTER_CONN_ROOM_REQ -102035 Incorrect format of the cross-room co-anchoring request
    ERR_SERVER_CENTER_CONN_ROOM_NO_SIG -102036 No signature for cross-room co-anchoring
    ERR_SERVER_CENTER_CONN_ROOM_DECRYPT_SIG -102037 Failed to decrypt the signature for cross-room co-anchoring
    ERR_SERVER_CENTER_CONN_ROOM_NO_KEY -102038 The key for decrypting the cross-room co-anchoring signature was not found
    ERR_SERVER_CENTER_CONN_ROOM_PARSE_SIG -102039 An error occurred when parsing a signature for cross-room co-anchoring
    ERR_SERVER_CENTER_CONN_ROOM_INVALID_SIG_TIME -102040 Incorrect timestamp of the cross-room co-anchoring signature
    ERR_SERVER_CENTER_CONN_ROOM_SIG_GROUPID -102041 Incorrect cross-room co-anchoring signature
    ERR_SERVER_CENTER_CONN_ROOM_NOT_CONNED -102042 No co-anchoring in this room
    ERR_SERVER_CENTER_CONN_ROOM_USER_NOT_CONNED -102043 The user did not initiate co-anchoring
    ERR_SERVER_CENTER_CONN_ROOM_FAILED -102044 Cross-room co-anchoring failed
    ERR_SERVER_CENTER_CONN_ROOM_CANCEL_FAILED -102045 Failed to cancel cross-room co-anchoring
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_ROOM_NOT_EXIST -102046 The room to be called in co-anchoring does not exist
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_REACH_MAX_ROOM -102047 The number of rooms that can join co-anchoring has reached the upper limit
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_NOT_EXIST -102048 The user to be called in co-anchoring does not exist
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_DELETED -102049 The user to be called in co-anchoring was deleted
    ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_FULL -102050 The number of users that can join co-anchoring has reached the upper limit
    ERR_SERVER_CENTER_CONN_ROOM_INVALID_SEQ -102051 Disordered co-anchoring request numbers

    Warning Codes

    Warning codes do not require your special attention, and you can choose whether to prompt the current user accordingly.

    Code Value Description
    WARNING_HW_ENCODER_START_FAIL 1103 An error occurred while enabling the hardware encoder, and the software encoder was automatically switch to
    WARNING_VIDEO_ENCODER_SW_TO_HW 1107 The current CPU utilization is too high to meet software encoding needs, and the hardware encoder was automatically switch to
    WARNING_INSUFFICIENT_CAPTURE_FPS 1108 Insufficient frame rate for video capturing through camera. This error may occur in Android mobile devices with an in-built beauty filter algorithm
    WARNING_SW_ENCODER_START_FAIL 1109 Failed to enable the software encoder
    WARNING_REDUCE_CAPTURE_RESOLUTION 1110 Camera resolution was lowered to meet the balance between current frame rate and performance
    WARNING_CAMERA_DEVICE_EMPTY 1111 No available camera device detected
    WARNING_MICROPHONE_DEVICE_EMPTY 1201 No available mic device detected
    WARNING_SPEAKER_DEVICE_EMPTY 1202 No available speaker device detected
    WARNING_MICROPHONE_NOT_AUTHORIZED 1203 The current application is not authorized to use the mic
    WARNING_MICROPHONE_DEVICE_ABNORMAL 1204 The audio capturing device is unavailable (for example, it is in use)
    WARNING_SPEAKER_DEVICE_ABNORMAL 1205 The audio playback device is unavailable (for example, it is in use)
    WARNING_VIDEO_FRAME_DECODE_FAIL 2101 Failed to decode the current video frame
    WARNING_AUDIO_FRAME_DECODE_FAIL 2102 Failed to decode the current audio frame
    WARNING_VIDEO_PLAY_LAG 2105 Video playback lagged
    WARNING_HW_DECODER_START_FAIL 2106 Failed to enable the hardware decoder, and the software decoder was used
    WARNING_VIDEO_DECODER_HW_TO_SW 2108 The hardware decoder failed to decode the first I frame of the current stream, and the SDK automatically switched to the software decoder
    WARNING_SW_DECODER_START_FAIL 2109 Failed to enable the software decoder
    WARNING_VIDEO_RENDER_FAIL 2110 Failed to render video
    WARNING_START_CAPTURE_IGNORED 4000 Capturing is already in progress. The request to enable capturing is ignored
    WARNING_AUDIO_RECORDING_WRITE_FAIL 7001 Failed to write the recorded audio to a file
    WARNING_ROOM_DISCONNECT 5101 Network connection was closed
    WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE 6001 The current role is viewer, so upstream audio/video data is ignored
    WARNING_NET_BUSY 1101 Unstable network condition: the upstream bandwidth is too low, and data upload is restricted
    WARNING_RTMP_SERVER_RECONNECT 1102 Publishing error. The network was disconnected, and is being reconnected. Maximum retry count: 3.
    WARNING_LIVE_STREAM_SERVER_RECONNECT 2103 Playback error. The network was disconnected and is being reconnected. Maximum retry count: 3.
    WARNING_RECV_DATA_LAG 2104 Unstable transmission of packets from the network. This may be caused by insufficient downstream bandwidth or uneven outbound stream from the anchor
    WARNING_RTMP_DNS_FAIL 3001 LVB error. DNS resolution failed
    WARNING_RTMP_SEVER_CONN_FAIL 3002 LVB error. Server connection failed
    WARNING_RTMP_SHAKE_FAIL 3003 LVB error. Handshake with the RTMP server failed
    WARNING_RTMP_SERVER_BREAK_CONNECT 3004 LVB error. The server actively closed the connection
    WARNING_RTMP_READ_WRITE_FAIL 3005 LVB error. RTMP read/write failed, and connection will be closed
    WARNING_RTMP_WRITE_FAIL 3006 LVB error. RTMP write failed (SDK internal error code, which will not be thrown out)
    WARNING_RTMP_READ_FAIL 3007 LVB error. RTMP read failed (SDK internal error code, which will not be thrown out)
    WARNING_RTMP_NO_DATA 3008 LVB error. If no data is sent in 30s, the server will actively close the connection
    WARNING_PLAY_LIVE_STREAM_INFO_CONNECT_FAIL 3009 LVB error. Failed to call "connect" to connect to the server (SDK internal error code, which will not be thrown out)
    WARNING_NO_STEAM_SOURCE_FAIL 3010 LVB error. Connection failed since there was no video in the stream address (SDK internal error code, which will not be thrown out)
    WARNING_ROOM_RECONNECT 5102 Network disconnected. Automatic reconnection has been enabled
    WARNING_ROOM_NET_BUSY 5103 Unstable network condition: the upstream bandwidth is too low, and data upload is restricted