tencent cloud

PrevNext

피드백

키워드를 검색하세요

Recent Pages

문서
Tencent Real-Time Communication
    문서
    Download PDF

    오류 코드

    마지막 업데이트 시간:2024-07-24 15:30:21
    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.
      개인정보 처리방침서비스 약관쿠키 정책