에러 가이드
플레이어가 에러 상태일 때 sauceclipPlayerError 로 알립니다. API·UI·영상 세 타입과 각 타입의 코드 값을 다룹니다.
sauceclipPlayerError
세 필드가 함께 전달됩니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| errorCode | String | 타입별 코드. 아래 표 참조 |
| errorDetails | String | 에러 상세. API 에러는 JSON 문자열 |
| errorType | String | 'api' · 'ui' · 'video' |
javascript
window.sauceclipPlayerError = function (params) { console.error(params.errorType, params.errorCode, params.errorDetails) }
에러 타입
| errorType | 발생 시점 | errorCode | errorDetails |
|---|---|---|---|
'api' | 플레이어가 호출한 API가 실패 | HTTP 상태 코드 | url · method · payload · statusCode · message 를 담은 JSON 문자열 |
'ui' | 플레이어 화면에서 스크립트 오류 | 오류 메시지 | 오류 스택 |
'video' | 영상 로딩·재생 실패 | 영상 에러 코드 또는 HLS 에러 타입 | 에러 상세 문자열 |
HLS 에러 타입
errorType 이 'video' 이고 스트리밍 단계에서 발생한 경우의 errorCode 입니다.
| errorCode | 설명 |
|---|---|
networkError | 네트워크 오류 |
mediaError | 미디어 오류 |
keySystemError | 키 시스템 오류 |
muxError | 멀티플렉싱 오류 |
otherError | 그 밖의 오류 |
영상 미디어 에러 코드
브라우저의 영상 요소가 낸 에러의 errorCode 입니다.
| errorCode | 설명 |
|---|---|
1 | 미디어 파일 로딩 중단 (MEDIA_ERR_ABORTED) |
2 | 네트워크 오류로 미디어 로딩 실패 (MEDIA_ERR_NETWORK) |
3 | 미디어 파일 디코딩 실패 (MEDIA_ERR_DECODE) |
4 | 지원하지 않는 미디어 형식 (MEDIA_ERR_SRC_NOT_SUPPORTED) |
Updated about 1 month ago
Did this page help you?