ErrorCode

오류 코드

기본 오류 코드

코드
설명
ERR_NULL
0
오류 없음

방 입장 오류 코드

TRTCCloud.enterRoom()은 방 입장이 실패하면 이러한 유형의 오류 코드를 트리거합니다. 콜백 API TRTCCloudDelegate.onEnterRoom() 및 TRTCCloudDelegate.OnError()를 사용하여 회의실 입장 오류에 대한 알림을 캡처할 수 있습니다.
코드
설명
ERR_ROOM_ENTER_FAIL
-3301
방 입장 실패
ERR_ENTER_ROOM_PARAM_NULL
-3316
빈 방 입장 매개변수. TRTCCloud.enterRoom(): API 호출 시 유효한 param 전달 여부 확인
ERR_SDK_APPID_INVALID
-3317
잘못된 sdkAppId 값
ERR_ROOM_ID_INVALID
-3318
잘못된 roomId 값
ERR_USER_ID_INVALID
-3319
잘못된 사용자 ID 값
ERR_USER_SIG_INVALID
-3320
잘못된 userSig 값
ERR_ROOM_REQUEST_ENTER_ROOM_TIMEOUT
-3308
방 입장 요청 시간 초과. 네트워크를 확인하십시오.
ERR_SERVER_INFO_PRIVILEGE_FLAG_ERROR
-100006
권한 티켓 확인 실패. privateMapKey가 올바른지 확인하십시오.
ERR_SERVER_INFO_SERVICE_SUSPENDED
-100013
서비스 이용 불가. Tencent Cloud 계정 연체 여부를 확인하십시오.
ERR_SERVER_INFO_ECDH_GET_TINYID
-100018
userSig 인증 실패. userSig가 올바른지 확인하십시오.

방 퇴장 오류 코드

TRTCCloud.exitRoom()은 방 종료가 실패하면 이 오류 코드를 트리거합니다. 콜백 API TRTCCloudDelegate.OnError()를 사용하여 오류에 대한 알림을 캡처할 수 있습니다.
코드
설명
ERR_ROOM_REQUEST_QUIT_ROOM_TIMEOUT
-3325
방 퇴장 요청 시간 초과

장치(카메라, 마이크, 스피커) 오류 코드

콜백 API TRTCCloudDelegate.OnError()를 사용하여 관련 알림을 캡처할 수 있습니다.
코드
설명
ERR_CAMERA_START_FAIL
-1301
카메라 활성화 실패. 예: Windows 또는 MacOS에서 카메라 구성 프로그램(드라이버)에 문제. 카메라를 껐다가 다시 켜거나 카메라를 다시 시작하거나 구성 프로그램을 업데이트합니다.
ERR_CAMERA_NOT_AUTHORIZED
-1314
카메라 권한 오류. 이 오류는 일반적으로 모바일 장치에서 발생하며 사용자가 카메라 권한을 거부했기 때문일 수 있습니다.
ERR_CAMERA_SET_PARAM_FAIL
-1315
잘못된 카메라 매개변수 설정(지원되지 않는 값 또는 기타)
ERR_CAMERA_OCCUPY
-1316
카메라가 점유됨. 다른 카메라로 시도해보십시오.
ERR_MIC_START_FAIL
-1302
마이크 활성화 실패. 예: Windows 또는 MacOS에서 마이크 구성 프로그램(드라이버)에 문제. 마이크를 껐다가 다시 켜거나 마이크를 다시 시작하거나 구성 프로그램을 업데이트합니다.
ERR_MIC_NOT_AUTHORIZED
-1317
마이크 권한 오류. 이 오류는 일반적으로 모바일 장치에서 발생하며 사용자가 마이크 권한을 거부했기 때문일 수 있습니다.
ERR_MIC_SET_PARAM_FAIL
-1318
마이크 매개변수 설정 실패
ERR_MIC_OCCUPY
-1319
마이크가 점유됨. 예: 사용자가 모바일 장치에서 통화 중일 때 발생합니다.
ERR_MIC_STOP_FAIL
-1320
마이크 끄기 실패
ERR_SPEAKER_START_FAIL
-1321
스피커 활성화 실패. 예: Windows 또는 MacOS에서 스피커 구성 프로그램(드라이버) 문제. 스피커를 껐다가 다시 켜거나 스피커를 다시 시작하거나 구성 프로그램을 업데이트합니다.
ERR_SPEAKER_SET_PARAM_FAIL
-1322
스피커 매개변수 설정 실패
ERR_SPEAKER_STOP_FAIL
-1323
스피커 끄기 실패

화면 공유 오류 코드

콜백 API TRTCCloudDelegate.OnError()를 사용하여 관련 알림을 캡처할 수 있습니다.
코드
설명
ERR_SCREEN_CAPTURE_START_FAIL
-1308
화면 캡처 시작 실패. 모바일 장치에서 사용자가 화면 공유 권한을 거부했기 때문일 수 있습니다. Windows 또는 MacOS인 경우, 화면 캡처 API의 매개변수가 요구 조건에 부합하는지 확인합니다.
ERR_SCREEN_CAPTURE_UNSURPORT
-1309
화면 캡처 실패. 버전을 확인하십시오(Android 5.0 이상, iOS 11.0 이상).
ERR_SERVER_CENTER_NO_PRIVILEDGE_PUSH_SUB_VIDEO
-102015
서브스트림 비디오 이미지 발송 권한 없음
ERR_SERVER_CENTER_ANOTHER_USER_PUSH_SUB_VIDEO
-102016
다른 사용자가 서브스트림 비디오 이미지를 보내는 중
ERR_SCREEN_CAPTURE_STOPPED
-7001
시스템에서 화면 캡처 중지

인코딩 및 디코딩 오류 코드

콜백 API TRTCCloudDelegate.OnError()를 사용하여 관련 알림을 캡처할 수 있습니다.
코드
설명
ERR_VIDEO_ENCODE_FAIL
-1303
비디오 프레임 인코딩 실패. 예: iOS 사용자가 다른 앱으로 전환할 때 발생하며, 시스템에서 하드웨어 인코더가 해제될 수 있습니다. 사용자가 재전환하면 하드웨어 인코더가 재시작 전에 이 오류가 발생할 수 있습니다.
ERR_UNSUPPORTED_RESOLUTION
-1305
지원되지 않는 비디오 해상도
ERR_AUDIO_ENCODE_FAIL
-1304
오디오 프레임 인코딩 실패. 예: SDK가 전달된 사용자 정의 오디오 데이터를 처리할 수 없을 때 발생합니다.
ERR_UNSUPPORTED_SAMPLERATE
-1306
지원되지 않는 오디오 샘플링 레이트

사용자 정의 캡처에 대한 오류 코드

콜백 API TRTCCloudDelegate.OnError()를 사용하여 관련 알림을 캡처할 수 있습니다.
코드
설명
ERR_PIXEL_FORMAT_UNSUPPORTED
-1327
지원되지 않는 pixel format
ERR_BUFFER_TYPE_UNSUPPORTED
-1328
지원되지 않는 buffer type

CDN 바인딩 및 혼합 스트림 오류 코드

콜백 API TRTCCloudDelegate.onStartPublishing() 및 TRTCCloudDelegate.onSetMixTranscodingConfig()를 사용하여 관련 알림을 캡처할 수 있습니다.
코드
설명
ERR_PUBLISH_CDN_STREAM_REQUEST_TIME_OUT
-3321
릴레이 요청 시간 초과
ERR_CLOUD_MIX_TRANSCODING_REQUEST_TIME_OUT
-3322
클라우드 믹스 트랜스코딩 요청 시간 초과
ERR_PUBLISH_CDN_STREAM_SERVER_FAILED
-3323
릴레이된 푸시에 대한 비정상적인 응답 패킷
ERR_CLOUD_MIX_TRANSCODING_SERVER_FAILED
-3324
클라우드 믹스 트랜스코딩에 대한 응답 패킷 예외
ERR_ROOM_REQUEST_START_PUBLISHING_TIMEOUT
-3333
Tencent Cloud의 라이브 스트리밍 CDN 푸시 시작 신호 시간 초과
ERR_ROOM_REQUEST_START_PUBLISHING_ERROR
-3334
Tencent Cloud의 라이브 스트리밍 CDN에 대한 푸시 신호 예외
ERR_ROOM_REQUEST_STOP_PUBLISHING_TIMEOUT
-3335
Tencent Cloud의 라이브 스트리밍 CDN에 대한 푸시 중지 신호 시간 초과
ERR_ROOM_REQUEST_STOP_PUBLISHING_ERROR
-3336
Tencent Cloud의 라이브 스트리밍 CDN으로 푸시 중지 신호 예외

크로스 룸 공동 앵커 관련 오류 코드

TRTCCloud.ConnectOtherRoom()은 크로스 룸 공동 앵커링이 실패하는 경우 이러한 유형의 오류 코드를 트리거합니다. 콜백 API TRTCCloudDelegate.onConnectOtherRoom()을 사용하여 관련 알림을 캡처할 수 있습니다.
코드
설명
ERR_ROOM_REQUEST_CONN_ROOM_TIMEOUT
-3326
공동 앵커 요청 시간 초과
ERR_ROOM_REQUEST_DISCONN_ROOM_TIMEOUT
-3327
공동 앵커 종료 요청 시간 초과
ERR_ROOM_REQUEST_CONN_ROOM_INVALID_PARAM
-3328
잘못된 매개 변수
ERR_CONNECT_OTHER_ROOM_AS_AUDIENCE
-3330
현재 시청자 역할이므로 공동 앵커링을 시작하거나 종료할 수 없습니다. 먼저 switchRole()를 통해 앵커 역할로 전환해야 합니다.
ERR_SERVER_CENTER_CONN_ROOM_NOT_SUPPORT
-102031
크로스룸 공동 앵커링 미지원
ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_NUM
-102032
공동 앵커 통화의 최댓값에 도달
ERR_SERVER_CENTER_CONN_ROOM_REACH_MAX_RETRY_TIMES
-102033
크로스 룸 공동 앵커링에 대한 재시도 횟수 소진
ERR_SERVER_CENTER_CONN_ROOM_REQ_TIMEOUT
-102034
크로스 룸 공동 앵커 요청 시간 초과
ERR_SERVER_CENTER_CONN_ROOM_REQ
-102035
잘못된 크로스 룸 공동 앵커 요청 형식
ERR_SERVER_CENTER_CONN_ROOM_NO_SIG
-102036
크로스 룸 공동 앵커링에 대한 서명 없음
ERR_SERVER_CENTER_CONN_ROOM_DECRYPT_SIG
-102037
크로스 룸 공동 앵커 서명 복호화 실패
ERR_SERVER_CENTER_CONN_ROOM_NO_KEY
-102038
크로스 룸 공동 앵커 서명 복호화 키 찾을 수 없음
ERR_SERVER_CENTER_CONN_ROOM_PARSE_SIG
-102039
크로스 룸 공동 앵커링 서명 구문 분석 오류
ERR_SERVER_CENTER_CONN_ROOM_INVALID_SIG_TIME
-102040
잘못된 크로스 룸 공동 앵커 서명 타임스탬프
ERR_SERVER_CENTER_CONN_ROOM_SIG_GROUPID
-102041
크로스 룸 공동 앵커 서명 내 방 Id 매칭 오류
ERR_SERVER_CENTER_CONN_ROOM_NOT_CONNED
-102042
크로스 룸 공동 앵커 서명 내 사용자 이름 매칭 오류
ERR_SERVER_CENTER_CONN_ROOM_USER_NOT_CONNED
-102043
사용자가 공동 앵커 시작하지 않음
ERR_SERVER_CENTER_CONN_ROOM_FAILED
-102044
크로스 룸 공동 앵커 시작 실패
ERR_SERVER_CENTER_CONN_ROOM_CANCEL_FAILED
-102045
크로스 룸 공동 앵커 취소 실패
ERR_SERVER_CENTER_CONN_ROOM_CONNED_ROOM_NOT_EXIST
-102046
공동 앵커링을 위해 연결된 방 없음
ERR_SERVER_CENTER_CONN_ROOM_CONNED_REACH_MAX_ROOM
-102047
공동 앵커 룸의 최댓값에 도달
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_NOT_EXIST
-102048
공동 앵커를 요청한 사용자 없음
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_DELETED
-102049
공동 앵커를 요청한 사용자 삭제
ERR_SERVER_CENTER_CONN_ROOM_CONNED_USER_FULL
-102050
공동 앵커링을 위해 호출되는 사용자의 모든 리소스가 점유됨
ERR_SERVER_CENTER_CONN_ROOM_INVALID_SEQ
-102051
순차 순서가 아닌 공동 앵커의 순번

경고 코드

경고 코드는 특별한 주의가 필요하지 않습니다. 상황에 따라 사용자에게 메시지를 표시할지 여부를 선택할 수 있습니다.
코드
설명
WARNING_HW_ENCODER_START_FAIL
1103
하드웨어 인코더 시작 실패. SDK가 자동으로 소프트웨어 인코더로 전환합니다.
WARNING_VIDEO_ENCODER_SW_TO_HW
1107
소프트웨어 인코더용 CPU가 충분하지 않음. SDK가 자동으로 하드웨어 인코더로 전환합니다.
WARNING_INSUFFICIENT_CAPTURE_FPS
1108
카메라가 캡처한 비디오의 프레임 속도가 충분하지 않음. 이 오류는 뷰티 필터 알고리즘이 내장된 Android 기기에서 발생할 수 있습니다.
WARNING_SW_ENCODER_START_FAIL
1109
소프트웨어 인코딩 실행 실패
WARNING_REDUCE_CAPTURE_RESOLUTION
1110
프레임 속도와 성능 간의 균형을 위해 카메라 해상도 낮춤.
WARNING_CAMERA_DEVICE_EMPTY
1111
감지된 카메라 없음
WARNING_CAMERA_NOT_AUTHORIZED
1112
사용자가 애플리케이션 카메라 액세스 권한을 부여하지 않았음
WARNING_MICROPHONE_DEVICE_EMPTY
1201
마이크가 감지되지 않음
WARNING_SPEAKER_DEVICE_EMPTY
1202
스피커가 감지되지 않음
WARNING_MICROPHONE_NOT_AUTHORIZED
1203
사용자가 애플리케이션 마이크 액세스 권한 미부여
WARNING_MICROPHONE_DEVICE_ABNORMAL
1204
오디오 캡처 장치를 사용 불가(예: 장치 사용 중)
WARNING_SPEAKER_DEVICE_ABNORMAL
1205
사용 가능한 오디오 재생 장치가 없음(예: 장치 사용 중)
WARNING_VIDEO_FRAME_DECODE_FAIL
2101
현재 비디오 프레임 디코딩 실패
WARNING_AUDIO_FRAME_DECODE_FAIL
2102
현재 오디오 프레임 디코딩 실패
WARNING_VIDEO_PLAY_LAG
2105
비디오 재생 지연
WARNING_HW_DECODER_START_FAIL
2106
하드웨어 디코더 시작 실패. 소프트웨어 디코더가 사용됩니다.
WARNING_VIDEO_DECODER_HW_TO_SW
2108
하드웨어 디코더의 현재 스트림의 첫 번째 I-프레임 디코딩 실패. SDK가 자동으로 소프트웨어 디코더로 전환합니다.
WARNING_SW_DECODER_START_FAIL
2109
소프트웨어 디코더 실행 실패
WARNING_VIDEO_RENDER_FAIL
2110
비디오 렌더링 실패
WARNING_START_CAPTURE_IGNORED
4000
동영상 캡처가 이미 시작됨. 요청이 무시됩니다.
WARNING_AUDIO_RECORDING_WRITE_FAIL
7001
녹음된 오디오 파일에 쓰기 실패
WARNING_ROOM_DISCONNECT
5101
네트워크 연결 끊김
WARNING_IGNORE_UPSTREAM_FOR_AUDIENCE
6001
현재 시청자 역할이므로 오디오/비디오 데이터 전송 요청이 무시됩니다.
WARNING_NET_BUSY
1101
잘못된 네트워크 연결. 제한된 업스트림 대역폭으로 인해 데이터 업로드가 차단됩니다.
WARNING_RTMP_SERVER_RECONNECT
1102
푸시 오류. 네트워크 재연결이 시도됩니다(최대 시도 횟수: 3).
WARNING_LIVE_STREAM_SERVER_RECONNECT
2103
풀 스트림 오류. 네트워크 재연결이 시도됩니다(최대 시도 횟수: 3).
WARNING_RECV_DATA_LAG
2104
불안정한 수신 패킷. 불충분한 다운스트림 대역폭 또는 앵커의 불안정한 스트림으로 인해 발생할 수 있습니다.
WARNING_RTMP_DNS_FAIL
3001
라이브 스트리밍 오류. DNS 확인 실패
WARNING_RTMP_SEVER_CONN_FAIL
3002
라이브 스트리밍 오류. 서버 연결 실패
WARNING_RTMP_SHAKE_FAIL
3003
라이브 스트리밍 오류. RTMP 서버와의 핸드셰이크 실패
WARNING_RTMP_SERVER_BREAK_CONNECT
3004
라이브 스트리밍 오류. 서버에 의해 연결이 끊어짐
WARNING_RTMP_READ_WRITE_FAIL
3005
라이브 스트리밍 오류. RTMP 읽기/쓰기 실패. 연결이 해제됩니다.
WARNING_RTMP_WRITE_FAIL
3006
라이브 스트리밍 오류. RTMP 쓰기 실패. SDK의 내부 오류 코드이며 외부에 노출되지 않습니다.
WARNING_RTMP_READ_FAIL
3007
라이브 스트리밍 오류. RTMP 읽기 실패. SDK의 내부 오류 코드이며 외부에 노출되지 않습니다.
WARNING_RTMP_NO_DATA
3008
라이브 스트리밍 오류. 30초 이상 데이터가 전송되지 않아 서버 연결이 끊깁니다.
WARNING_PLAY_LIVE_STREAM_INFO_CONNECT_FAIL
3009
라이브 스트리밍 오류. 서버에 연결하기 위한 connect 호출 실패. SDK의 내부 오류 코드이며 외부에 노출되지 않습니다.
WARNING_NO_STEAM_SOURCE_FAIL
3010
라이브 스트리밍 오류. 스트림 주소에 비디오가 없어 연결에 실패했습니다. SDK의 내부 오류 코드이며 외부에 노출되지 않습니다.
WARNING_ROOM_RECONNECT
5102
네트워크 연결 끊김. 재연결 중입니다.
WARNING_ROOM_NET_BUSY
5103
잘못된 네트워크 연결: 제한된 업스트림 대역폭으로 인해 데이터 업로드가 차단되었습니다.