tencent cloud

PrevNext

피드백

키워드를 검색하세요

Recent Pages

문서
Tencent Real-Time Communication
    문서
    Download PDF

    오류 코드

    마지막 업데이트 시간:2022-06-28 11:04:41
    PDF 다운로드
      주의：

      본문은 4.x.x 버전의 TRTC Web SDK에 적용됩니다.

      오류 코드 정의

      Key getCode 에러 코드 설명
      INVALID_PARAMETER 4096 0x1000 잘못된 매개 변수
      처리 제안: 전송 매개 변수가 유형이 올바른지 등 SDK 요구 사항을 충족하는지 확인하십시오.
      INVALID_OPERATION 4097 0x1001 잘못된 작업
      처리 제안: API 호출 로직이 해당 인터페이스 문서에 따라 SDK 요구 사항을 충족하는지 확인하십시오. 예: 방 미입장 시 publish 인터페이스를 호출하는 것은 금지되어 있습니다.
      NOT_SUPPORTED 4098 0x1002 SDK 인터페이스를 호출할 때 발생하며 현재 브라우저가 해당 인터페이스 호출을 지원하지 않습니다
      • 설명: SDK 인터페이스를 호출할 때 발생하며 현재 브라우저가 해당 인터페이스 호출을 지원하지 않습니다
      • 처리 제안: SDK에서 지원하는 브라우저를 사용하도록 안내합니다. 브라우저 지원 점검을 참고하십시오
      DEVICE_NOT_FOUND 4099 0x1003 현재 장치에 마이크나 카메라가 없지만 마이크나 카메라를 수집하려고 합니다
      처리 제안: 사용자가 장치의 카메라와 마이크가 정상인지 확인하도록 안내합니다. 서비스측은 방에 들어가기 전에 장치 점검 로직을 추가해야 합니다. 통화 전 환경 및 장치 점검을 참고하십시오.
      INITIALIZE_FAILED 4100 0x1004 LocalStream.initialize() 수집 실패, 자세한 처리 제안을 참고하십시오.
      SIGNAL_CAHNNEL_SETUP_FAILED 16385 0x4001 신호 채널 설정 실패. 일반적으로 Tencent Cloud 계정과 관련이 있습니다. 계정 오류를 참고하십시오.
      SIGNAL_CHANNEL_ERROR 16386 0x4002 신호 채널 오류.
      ICE_TRANSPORT_ERROR 16387 0x4003 ICE Transport 연결 오류, 즉, 멀티미디어 데이터 전송 채널 오류입니다. 이것은 주로 클라이언트의 비정상적인 UDP 포트에 의해 발생합니다(사용자 컴퓨터의 방화벽 또는 라우터의 방화벽의 포트 제한에 의해 발생할 수 있음). 특정 포트에 대해서는 포트 얼로우리스트를 참고하십시오.
      JOIN_ROOM_FAILED 16388 0x4004 방 입장 실패. 자세한 내용은 방 입장 오류를 참고하십시오
      CREATE_OFFER_FAILED 16389 0x4005 sdp offer 생성 실패.
      SIGNAL_CHANNEL_RECONNECTION_FAILED 16390 0x4006 WebSocket 신호 터널 재연결 실패
      • 설명: WebSocket 연결이 끊어지면 SDK는 여러 번 재연결을 시도하고, 실패 시 이 오류 발생
      • 처리 제안: 사용자에게 네트워크를 확인하고 다시 방에 들어가도록 알립니다
      UPLINK_RECONNECTION_FAILED 16391 0x4007 업스트림 PeerConnection 재연결 실패
      • 설명: 업스트림 PeerConnection의 연결이 끊어지면 SDK는 여러 번 재연결을 시도하며 실패 시 이 오류 발생
      • 처리 제안: 사용자에게 네트워크를 확인한 다음 다시 푸시 스트림하거나 방에 다시 입장하도록 알립니다
      DOWNLINK_RECONNECTION_FAILED 16392 0x4008 다운스트림 PeerConnection 재연결 실패
      • 설명: 다운스트림 PeerConnection이 비정상적으로 연결이 끊긴 경우 SDK는 여러 번 재연결을 시도하며 실패 시 이 오류 발생
      • 처리 제안: 사용자에게 네트워크를 확인하고 다시 방에 입장하도록 알립니다
      REMOTE_STREAM_NOT_EXIST 16400 0x4010 원격 스트림이 존재하지 않음
      • 설명: A가 B가 푸시한 스트림을 구독하려고 시도할 때 B가 푸시 스트림을 취소하여 A가 B를 구독하는데 실패
      • 처리 제안: 정상적인 인터랙티브 프로세스에 속하며 액세스 측에서 처리할 필요가 없습니다
      CLIENT_BANNED 16448 0x4040 사용자가 방에서 퇴장됨. 이유:
      • 같은 이름의 사용자가 같은 방에 입장, 참고: 같은 이름의 사용자는 같은 방에 동시에 입장할 수 없으며, 양측 간에 비정상적인 음성 및 영상 통화가 발생할 수 있습니다. 서비스측에서 이런 상황을 방지해야 합니다.
      • 서버 API를 사용하여 계정 관리자에 의해 방에서 퇴장됩니다
      SERVER_TIMEOUT 16449 0x4041 MediaConnect 서비스 시간 초과
      SUBSCRIPTION_TIMEOUT 16450 0x4042 원격 스트림 구독 시간 초과
      PLAY_NOT_ALLOWED 16451 0x4043 자동 재생 금지 오류
      • 설명: 'play()'를 호출하여 멀티미디어를 재생할 때 자동 재생 정책의 제한으로 인해 자동으로 재생되지 않음
      • 처리 제안: 사용자는 'resume()'을 호출하여 제스처 작업을 통해 계속 재생하도록 안내 해야 합니다. 자동 재생 제한 처리 제안을 참고하십시오
      DEVICE_AUTO_RECOVER_FAILED 16452 0x4044 카메라 및 마이크의 자동 수집에 실패했습니다. LocalStream의 error 이벤트 발생
      • 스트리밍 중인 사용자의 미디어 장치가 변경되면(예시: 카메라 연결/해제, 마이크, 연결 헐거워짐 등) SDK는 수집 복구를 시도합니다. 이 오류 발생 시 복구 실패
      • 처리 제안: 미디어 장치가 자동으로 수집을 복구하지 못한다는 사실을 사용자에게 알립니다. 카메라와 마이크 연결이 헐거운지 확인하고, 다른 애플리케이션에 의해 점유되고 있지 않은지 확인합니다.
      • 페이지에 재시도 버튼을 제공하여, 사용자가 재시도를 클릭하면 카메라와 마이크가 재수집됩니다
      START_PUBLISH_CDN_FAILED 16453 0x4045 CDN으로 푸시 스트림 시작 실패
      STOP_PUBLISH_CDN_FAILED 16454 0x4046 CDN으로 푸시 스트림 중지 실패
      START_MIX_TRANSCODE_FAILED 16455 0x4047 혼합 스트림 및 트랜스 코딩 시작 실패
      STOP_MIX_TRANSCODE_FAILED 16456 0x4048 혼합 스트림 및 트랜스 코딩 중지 실패
      NOT_SUPPORTED_H264 16457 0x4049 현재 장치는 H.264 미지원
      SWITCH_ROLE_FAILED 16458 0x404a 역할 전환 실패
      UNKOWN 65535 0xFFFF 알수없는 오류

      계정 오류

      에러 코드 오류 유형 설명
      -8 계정 시스템 sdkAppId가 정확하지 않습니다. sdkAppId가 올바르게 입력되었는지 확인하십시오
      70001 계정 시스템 userSig가 만료되었습니다. 다시 생성하십시오. 서명이 생성 직후 만료되는 경우 유효 기간이 너무 짧거나 0으로 설정되어 있는지 확인하십시오
      70002 계정 시스템 userSig의 길이는 0입니다. 서명 계산을 위한 소스 코드를 얻기 위해 sign_src에 액세스하고 서명이 올바르게 계산되었는지 확인하기 위해 매개변수를 확인하십시오
      70003 계정 시스템 userSig 인증에 실패했습니다. 짧은 버퍼 길이 등으로 인해 userSig가 잘렸는지 확인하십시오
      70004 계정 시스템 userSig 인증에 실패했습니다. 짧은 버퍼 길이 등으로 인해 userSig가 잘렸는지 확인하십시오
      70005 계정 시스템 userSig 인증에 실패했습니다. 생성된 userSig가 올바른지 도구를 사용하여 확인하십시오.
      70006 계정 시스템 userSig 인증에 실패했습니다. 생성된 userSig가 올바른지 도구를 사용하여 확인하십시오
      70007 계정 시스템 userSig 인증에 실패했습니다. 생성된 userSig가 올바른지 도구를 사용하여 확인하십시오
      70008 계정 시스템 userSig 인증에 실패했습니다. 생성된 userSig가 올바른지 도구를 사용하여 확인하십시오
      70009 계정 시스템 비즈니스 공개키로 userSig 인증에 실패했습니다. userSig 생성에 사용된 개인키와 sdkAppId가 일치하는지 확인하십시오
      70010 계정 시스템 userSig 인증에 실패했습니다. 생성된 userSig가 올바른지 도구를 사용하여 확인하십시오
      70013 계정 시스템 userSig의 userId가 요청의 userId와 다릅니다. 로그인 시 입력한 userId가 userSig에 입력된 것과 동일한지 확인하십시오
      70014 계정 시스템 userSig의 sdkAppId가 요청의 sdkAppId와 다릅니다. 로그인 시 입력한 sdkAppId가 userSig에 입력된 것과 동일한지 확인하십시오
      70015 계정 시스템 이 sdkAppId 및 계정 유형에 대한 인증 방법을 찾을 수 없습니다. 계정 연동이 되었는지 확인하십시오
      70016 계정 시스템 가져온 공개키의 길이는 0입니다. 공개키가 업로드되었는지 확인하십시오. 방금 업로드한 경우 10분 후에 다시 시도하십시오
      70017 계정 시스템 서드 파티 티켓의 내부 확인 시간이 초과되었습니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70018 계정 시스템 서드 파티 티켓의 내부 확인에 실패했습니다
      70019 계정 시스템 HTTPS 기반 유효성 검사를 위한 티켓 필드가 비어 있습니다. 올바른 userSig를 입력하십시오
      70020 계정 시스템 sdkAppId를 찾을 수 없습니다. Tencent Cloud에서 설정했는지 확인하십시오
      70052 계정 시스템 잘못된 userSig입니다. 새로 생성하고 다시 시도하십시오
      70101 계정 시스템 빈 요청 패킷입니다
      70102 계정 시스템 요청 패킷에 잘못된 계정 유형이 있습니다
      70103 계정 시스템 전화번호 형식이 잘못되었습니다
      70104 계정 시스템 이메일 주소 형식이 잘못되었습니다
      70105 계정 시스템 잘못된 TLS 계정 형식입니다
      70106 계정 시스템 잘못된 계정 형식 유형입니다
      70107 계정 시스템 userId가 등록되지 않았습니다
      70113 계정 시스템 잘못된 배치 수량입니다
      70114 계정 시스템 보안상의 이유로 제한됩니다
      70115 계정 시스템 uin이 sdkAppId 개발자의 uin과 일치하지 않습니다
      70140 계정 시스템 sdkAppId와 acctype이 일치하지 않습니다
      70145 계정 시스템 잘못된 계정 유형입니다
      70169 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70201 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70202 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70203 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70204 계정 시스템 sdkAppId에 일치하는 acctype이 없습니다
      70205 계정 시스템 acctype을 찾지 못했습니다. 다시 시도하십시오
      70206 계정 시스템 요청에 잘못된 배치 수량이 있습니다
      70207 계정 시스템 내부 오류입니다. 다시 시도하십시오
      70208 계정 시스템 내부 오류입니다. 다시 시도하십시오
      70209 계정 시스템 개발자의 uin을 가져오지 못했습니다
      70210 계정 시스템 요청한 uin은 개발자의 uin이 아닙니다
      70211 계정 시스템 요청에 잘못된 uin이 있습니다
      70212 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70213 계정 시스템 내부 데이터에 액세스하지 못했습니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70214 계정 시스템 내부 티켓 확인에 실패했습니다
      70221 계정 시스템 잘못된 로그인 상태입니다. UserSig로 로그인을 다시 인증하십시오
      70222 계정 시스템 내부 오류입니다. 다시 시도하십시오
      70225 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70231 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70236 계정 시스템 user signature 인증에 실패했습니다
      70308 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70346 계정 시스템 티켓 인증에 실패했습니다
      70347 계정 시스템 티켓이 만료되어 인증에 실패했습니다
      70348 계정 시스템 내부 오류입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70362 계정 시스템 내부 시간 초과입니다. 다시 시도하십시오. 재시도 실패 시 고객센터로 문의하십시오
      70401 계정 시스템 내부 오류입니다. 다시 시도하십시오
      70402 계정 시스템 잘못된 매개 변수. 모든 필수 필드를 채우고 입력한 값이 요구 사항을 충족하는지 확인하십시오
      70403 계정 시스템 작업 요청자가 애플리케이션 관리자가 아니며 작업을 수행할 권한이 없습니다
      70050 계정 시스템 로그인 실패 및 여러 번의 재시도 때문에 계정이 일시적으로 잠겼습니다. 티켓이 맞는지 확인하고 잠시 후 다시 시도하십시오
      70051 계정 시스템 차단된 계정입니다. 고객센터로 문의하십시오

      방 입장 오류

      에러 코드 오류 정보
      10006 연체로 인해 서비스가 중단되었습니다. TRTC 콘솔에 로그인하고 생성한 애플리케이션을 찾은 다음 애플리케이션 정보를 클릭하여 TRTC 서비스 상태를 확인합니다
      -10011 알 수 없는 서버 오류입니다. 다시 시도하십시오
      -10012 roomId가 전달되지 않았거나 요구 사항을 충족하지 않습니다. string 유형으로 roomId를 사용하려면 TRTC.createClient를 호출할 때 useStringRoomId를 true로 설정합니다
      -10013 userSig 인증에 실패했습니다
      -10015 서버에서 서버 노드를 가져오지 못했습니다. 다시 시도하십시오
      -10016 서버에 룸을 만들지 못했습니다. roomId가 트래픽 제어 범위 내에 있는지 확인하십시오
      -10018 고급 권한 제어 기능 활성화 후 client.join은 privateMapKey를 전달하지 않거나 privateMapKey는 ‘ ’ 입니다. 자세한 내용은 고급 권한 제어 기능 활성화를 참고하십시오
      -10019 고급 권한 제어가 활성화된 후 client.join이 전달하는 privateMapKey가 요구 사항을 충족하지 않습니다. 자세한 내용은 고급 권한 제어 기능 활성화를 참고하십시오
      -10020 서버 연결 시간이 초과되었습니다. 다시 시도하십시오
      -100027 애플리케이션의 TRTC 서비스 상태가 정상인지 확인하십시오. 그렇지 않은 경우 TRTC 콘솔에서 서비스를 활성화하고 다시 방에 입장하십시오.

      일반적인 오류 및 처리 방법

      다음 오류는 응용 프로그램 측 개입을 통해 수정해야 합니다. 예를 들어 카메라 액세스가 거부된 경우 영상 통화를 할 수 있으려면 애플리케이션에서 사용자에게 카메라 액세스 권한을 부여하라는 메시지를 표시해야 합니다.

      오류 정보 오류 원인 솔루션
      publish timeout publish 시간 초과 새로 고침하고 publish()를 다시 호출합니다
      join room timeout 방 입장 시간 초과 페이지를 새로고침하고 다시 시도하십시오
      DTLS Transport connection timeout (10s) DTLS Transport 연결 시간 초과 새로고침하고 다시 시도하십시오
      failed to connect to remote server via websocket websocket 연결 실패 새로고침하고 다시 시도하십시오
      ICE/DTLS Transport connection failed 미디어 전송 연결 설정 실패 방화벽 설정을 확인하십시오
      previous publishing is ongoing, please avoid re-publishing 이미 publishing 상태 publish 후 다시 publish()를 호출하지 마십시오
      AbortError 알 수 없는 장치/시스템 오류로 인해 장치에 액세스 불가 통화 전에 장치를 테스트하십시오
      NotReadableError 하드웨어, 브라우저 또는 운영 체제의 웹 수준 오류로 인해 액세스할 수 없는 장치를 찾을 수 없음 브라우저의 오류 메시지 처리에 따라 사용자에게 현재 카메라/마이크에 대한 액세스를 요청하는 다른 애플리케이션이 없는지 확인하고 다시 시도하십시오
      NotFoundError 요청 매개변수의 미디어(오디오, 비디오 또는 화면 공유)를 찾을 수 없음 통화 전에 장치를 테스트하십시오
      NotAllowedError 사용자가 현재 브라우저 인스턴스의 오디오, 비디오, 화면 공유 액세스 요청을 거절한 상태 사용자는 카메라/마이크의 액세스를 인증해야 멀티미디어 통화를 할 수 있습니다
      SignalChannel reconnect failed websocket 연결 끊김 새로고침하고 다시 시도하십시오
      duplicate publishing, please unpublish and then re-publish publish 중복 publish() 전에 unpublish()를 먼저 호출하십시오
      OverconstrainedError 브라우저에서 cameraId / microphoneId를 가져올 수 없음 cameraId / microphoneId의 값이 비어 있지 않은 유효한 문자열인지 확인하십시오
      RtcError: no valid ice candidate found TRTC Web SDK가 STUN에 홀 펀칭 실패 자세한 내용은 방화벽 설정을 참고하십시오
      문의하기

      고객의 업무에 전용 서비스를 제공해드립니다.

      문의하기
      기술 지원

      더 많은 도움이 필요하시면, 티켓을 통해 연락 바랍니다. 티켓 서비스는 연중무휴 24시간 제공됩니다.

      티켓 제출
      연중무휴 24시간 전화 지원
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      개인정보 처리방침서비스 약관쿠키 정책