이 페이지는 Cloud Translation API를 통해 번역되었습니다.

오류 코드

이 페이지에서 다루지 않는 문제가 있는 경우 Google Cast 지원 페이지에서 질문에 대한 답변을 확인하세요.

Cast SDK 오류 코드

오류 이벤트 또는 미디어 오류 메시지에서 전송된 Cast SDK와 관련된 오류 코드입니다.

이름	코드	설명	해결 방법
앱	900	프레임워크 외부에서 오류가 발생하면 (예: 이벤트 핸들러에서 오류가 발생할 때) 반환됩니다.	Cast 프레임워크 외부의 오류를 조사합니다.
BREAK_CLIP_LOADING_오류	901	브레이크 클립 로드 인터셉터가 실패하면 반환됩니다.	브레이크 클립의 콘텐츠를 살펴봅니다.
BREAK_SEEK_INTERCEPTOR_오류	902	중단 찾기 인터셉터가 실패하면 반환됩니다.	중단 찾기 인터셉터가 올바른지 확인합니다.
이미지 오류	903	이미지 로드에 실패하면 반환됩니다.	이미지 URL이 올바른 위치를 가리키는지 확인합니다.
로드_중단됨	904	정류장 또는 다른 로드에 의해 로드가 중단되었습니다.	다른 작업으로 인해 로드가 중단되었는지 확인합니다.
로드 실패	905	로드 명령어가 실패했습니다.	로드 요청이 제대로 설정되어 있고 미디어가 재생 가능한지 확인합니다.
미디어_오류_메시지	906	발신자에게 오류 메시지가 전송되었습니다.	오류에 대한 정보는 웹 수신자 또는 발신자에게 확인하세요.
일반	909	알 수 없는 오류가 발생하면 반환됩니다.	예상치 못한 문제가 발생했습니다. 이러한 경우는 드뭅니다.

미디어 플레이어 라이브러리 오류 코드

오류 이벤트 또는 미디어 오류 메시지에서 전송한 MPL의 재생 관련 오류 메시지입니다.

이름	코드	설명	해결 방법
미디어_알 수 없음	100	미디어 요소에서 플랫폼에서 알 수 없는 오류가 발생했습니다.	미디어 요소에 MediaError.MEDIA_ERR_* 중 하나임을 나타내지 않는 오류가 발생했습니다. 이러한 경우는 드뭅니다.
미디어 취소	101	미디어 요소에서 MediaError.MEDIA_ERR_ABORTED 오류가 발생했습니다.	사용자의 요청에 따라 미디어 리소스의 가져오기 프로세스가 취소되었습니다. 이는 대개 재생 중단으로 인해 발생합니다.
미디어_디코드	102	미디어 요소에서 MediaError.MEDIA_ERR_DECODE 오류가 발생했습니다.	개발자는 스트림의 인코딩 매개변수를 확인해야 합니다.
미디어_네트워크	103	미디어 요소에서 MediaError.MEDIA_ERR_NETWORK 오류가 발생했습니다.	Cast에서 다운로드에 미디어 요소를 사용하지 않기 때문에 미디어 데이터를 다운로드할 수 없습니다. 이 문제는 앱에서 발생할 수 있습니다. 필요한 경우 Cast 문제 추적기를 통해 보고하세요.
MEDIA_SRC_NOT_지원됨	104	미디어 요소에서 MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED 오류가 발생했습니다.	개발자 데이터 세그먼트를 확인하고 코덱이 Cast 지원 형식에 포함되어 있는지 확인합니다.
SOURCE_BUFFER_실패	110	Cast에서 기존 미디어 소스에 소스 버퍼를 추가할 수 없습니다. 웹 암호화를 참고하세요.	앱의 매니페스트에 있는 코덱 스트림에 지정된 잘못된 코덱인 경우가 많습니다. Cast Issue Tracker를 통해 보고합니다.
미디어 키_네트워크	201	미디어 라이선스에서 라이선스 요청을 게시하기 위해 XhrIo를 사용할 때 네트워크 오류가 발생했습니다.	개발자가 라이선스 서버의 유효성을 검사합니다.
MEDIAKEYS_지원되지 않음	202	다음과 같은 두 가지 경우가 해당됩니다. 미디어 세션을 사용하여 EME에서 요청을 생성할 때 키 오류가 발생했습니다. EME 미디어 키를 초기화할 수 없습니다.	미디어 데이터 다운로드는 실패했지만 Cast는 다운로드에 미디어 요소를 사용하지 않으므로 Cast Issue Tracker를 통해 보고하세요.
미디어 키 웹키	203	브라우저에서 지원되는 기본 웹 암호화 기능을 사용할 때 복호화하는 중에 오류가 발생했습니다. Web Crypto API를 참조하세요.	Cast Issue Tracker를 통해 신고해 주세요.
네트워크_알 수 없음	300	[301-399] 범위에서 처리되지 않는 리소스를 가져올 때 일반 네트워크 오류가 발생했습니다.	개발자는 가져오는 콘텐츠에 액세스할 수 있고 서버의 응답이 올바르게 구성되어 있는지 확인해야 합니다.
세그먼트 네트워크	301*	모든 비트 전송률에서 세그먼트를 가져올 수 없습니다 (지수 백오프를 3회 다시 시도함).	개발자는 세그먼트를 실제로 사용할 수 있는지 검증해야 합니다. 사용자가 이러한 세그먼트에 도달할 수 없는 경우도 있습니다.
HLS_네트워크_MASTER_재생목록	311개*	마스터 재생목록 m3u8 파일을 3회 다시 가져올 수 없습니다.	개발자는 재생목록을 실제로 사용할 수 있는지 확인해야 합니다. 재생목록에 도달할 수 없는 사용자도 해당할 수 있습니다.
HLS_네트워크_재생목록	312개*	3회 다시 시도하여 미디어 (비트 전송률) 재생목록 m3u8 파일을 가져올 수 없습니다.	개발자는 재생목록을 실제로 사용할 수 있는지 확인해야 합니다. 재생목록에 도달할 수 없는 사용자도 해당할 수 있습니다.
HLS_NETWORK_NO_KEY_응답	313	복호화 키 요청이 응답을 반환하지 않았습니다.	개발자는 복호화 키 관리 서비스의 유효성을 검사해야 합니다.
HLS_NETWORK_KEY_로드	314개*	HLS 복호화 키를 요청하는 데 사용된 XhrIO가 실패했습니다.	개발자는 복호화 키 관리 서비스의 유효성을 검사해야 합니다.
HLS_네트워크_무효_세그먼트	315	처리를 위해 수신된 HLS 세그먼트는 TS 또는 mp4 AAC 세그먼트가 아닙니다. MPL 버그 또는 웹 수신기 앱 버그의 구성일 수 있습니다.	개발자는 세그먼트가 TS 또는 AAC인지 확인해야 합니다.
HLS_세그먼트_대기	316	HLS 세그먼트 파싱에 실패하면 반환됩니다.	개발자는 세그먼트가 올바르게 구성되었는지 확인해야 합니다.
DASH_네트워크	321개*	DASH 매니페스트를 가져오기 위한 XHR 요청이 응답 없이 실패했습니다.	네트워크 관련 오류 진단은 별표 섹션을 참조하세요.
DASH_NO_INIT	322	첫 번째 DASH init 세그먼트에서 초기화 데이터를 추출할 수 없습니다.	개발자는 DASH 초기화 세그먼트의 유효성을 검사해야 합니다.
매끄러운 네트워크	331개*	DASH 매니페스트를 가져오기 위한 XHR 요청이 응답 없이 실패했습니다.	네트워크 관련 오류 진단은 별표 섹션을 참조하세요.
SMOOTH_NO_MEDIA_데이터	332	처리를 위해 다운로드한 세그먼트에는 미디어 데이터가 없습니다.	개발자는 부드러운 세그먼트의 유효성을 검사해야 합니다.
HLS_MAIFEST_MASTER	411	HLS 매니페스트 파일을 파싱하지 못했습니다. 또는 m3u8에서 아직 MPL이 이해하지 못하는 것	매니페스트 URL의 콘텐츠를 검사합니다.
HLS_매니페스트_재생목록	412	미디어 재생목록 파일을 파싱할 수 없습니다. 또는 m3u8에서 아직 MPL이 이해하지 못하는 것	미디어 재생목록 URL의 콘텐츠를 살펴봅니다.
DASH_MANIFEST_NO_기간	421	대시 매니페스트를 정규화할 때 마침표가 없는 것을 발견했습니다. 이는 정상입니다.	개발자는 DASH 매니페스트의 유효성을 검사해야 합니다.
DASH_MANIFEST_NO_MIMETYPE	422	매니페스트에는 표현의 MIME 유형이 없습니다.	개발자는 표현에 오디오/동영상/텍스트 MIME 유형을 지정해야 합니다.
DASH_INVALID_세그먼트_정보	423	MPL이 매니페스트의 표현에 명시된 대로 사용 가능한 세그먼트의 길이를 초과하는 세그먼트 색인을 요청합니다.	Google Cast 지원 페이지의 링크를 사용하여 보고합니다.
매끄럽게 조정	431	매끄러운 매니페스트가 표준을 준수하지 않습니다.	개발자가 다음 문제를 해결해야 합니다. SSP 없음 잘못된 동영상 품질 잘못된 오디오 품질 잘못된 오디오 코덱 비공개 데이터 잘못된 보호 정보 품질 수준 없음 알 수 없는 미디어

Shaka 플레이어 오류 코드

샤카 플레이어와 관련된 오류 코드는 샤카 플레이어 오류 클래스 문서를 참조하세요.

일반적인 네트워크 오류

HTTP 오류	상태 코드	설명	해결 방법
BAD_REQUEST	400	형식이 잘못된 구문으로 인해 서버에서 요청을 인식할 수 없습니다. 클라이언트는 수정 없이 요청을 반복하면 안 됩니다(SHOULD NOT).	URL에 문제가 있습니다. 애플리케이션 개발자에게 확인
UNAUTHORIZED	401	요청에 사용자 인증이 필요합니다.	올바른 인증 정보가 있는지 애플리케이션을 확인합니다.
NOT_FOUND	404	클라이언트가 서버와 통신할 수 있지만 서버에서 요청된 항목을 찾을 수 없음	개발자는 URL 리소스를 확인하여 리소스가 존재하는지 확인합니다.
REQUEST_TIMEOUT	408	서버가 대기 준비가 완료된 시간 내에 클라이언트가 요청을 생성하지 않았습니다. 클라이언트는 나중에 수정 없이 요청을 반복할 수 있습니다(MAY).	리소스 (서버 확장성) 또는 실제 네트워크 문제일 수 있습니다.
INTERNAL_SERVER_오류	500	서버에 예상치 못한 상황이 발생하여 요청을 처리할 수 없습니다.	개발자가 서버 문제를 확인합니다.
BAD_GATEWAY	502	게이트웨이 또는 프록시 역할을 하는 서버가 요청을 처리하려고 할 때 액세스한 업스트림 서버로부터 잘못된 응답을 받았습니다.	개발자는 서버 구성을 확인합니다.
SERVICE_UNAVAILABLE	503	현재 서버의 과부하 또는 유지보수로 인해 서버에서 요청을 처리할 수 없습니다. 이는 일시적인 조건으로서 일부 지연 후에 완화됩니다.	개발자는 서버 구성, 특히 서비스의 확장성을 확인합니다.
GATEWAY_TIMEOUT	504	서버가 게이트웨이나 프록시 역할을 하는 동안 URI에 지정된 업스트림 서버에서 제때 응답을 받지 못했습니다.	개발자는 에지 서버와 원본 노드 간의 서버 구성 및 연결을 확인합니다.

메모

오류 코드 뒤에 별표 (*)가 표시되면 오류 코드가 더 추가될 수 있습니다. 형식은 다음과 같습니다.

{Error Code}{Closure Network Error Code}{HTTP Status Code}

자세한 내용은 HTTP 상태 코드를 참조하세요.

3016404 예시는 다음 세 부분으로 구성됩니다.

301	세그먼트 네트워크 오류입니다.
6	HTTP 오류입니다.
404	HTTP를 찾을 수 없음 상태입니다.

네트워크 오류의 특성 - 이러한 오류 중 일부는 실행 가능하지만 그렇지 않은 이유는 네트워크 작업의 특성으로 인해 발생합니다. 예를 들어 시간 초과를 나타내는 오류 3018408은 사용자 연결 불량의 원인이 될 수 있으며, 이는 Cast팀이나 개발자가 할 수 있는 일이 많지 않습니다. 개발자의 CDN에도 문제가 있다는 뜻일 수도 있으니 주의하세요. 반면 오류 3116403은 매니페스트 요청은 성공적으로 이루어졌지만 서버에서 이를 거부하는 것을 의미합니다. 이는 개발자가 확인해야 하는 CORS, 인증, 기타 서버 또는 통합 문제일 수 있습니다.

Chrome 원격 디버거