tencent cloud

Tencent Real-Time Communication

소식 및 공지 사항
제품 업데이트
Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가
TRTC 월간 구독 패키지 출시 관련 안내
제품 소개
제품 개요
기본 개념
제품 기능
제품 장점
응용 시나리오
성능 데이터
구매 가이드
Billing Overview
무료 시간 안내
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
과금 FAQ
Refund Instructions
신규 사용자 가이드
Demo 체험
Call
개요(TUICallKit)
Activate the Service
Run Demo
빠른 통합(TUICallKit)
오프라인 푸시
Conversational Chat
온클라우드 녹화(TUICallKit)
AI Noise Reduction
UI 사용자 정의
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
릴리스 노트
FAQs
라이브 스트리밍
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo 실행
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK 다운로드
API 코드 예시
Usage Guidelines
API 클라이언트 API
고급 기능
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
콘솔 가이드
애플리케이션 관리
사용량 통계
모니터링 대시보드
개발 보조
Solution
Real-Time Chorus
FAQs
과금 개요
기능 관련
UserSig 관련
방화벽 제한 처리
설치 패키지 용량 축소 관련 질문
Andriod 및 iOS 관련
Web 관련
Flutter 관련
Electron 관련
TRTCCalling Web 관련
멀티미디어 품질 관련
기타 질문
Protocols and Policies
컴플라이언스 인증
보안 백서
정보 보안에 관한 참고 사항
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집

오류 코드

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-24 15:30:21

오류 코드

기본 오류 코드

코드
설명
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
잘못된 네트워크 연결: 제한된 업스트림 대역폭으로 인해 데이터 업로드가 차단되었습니다.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백