GuidesAPI GuideChangelog
Log In
Guides

에러 브릿지

플레이어가 에러 상태일 때 sauceclipPlayerError 로 알립니다. API·UI·영상 세 타입과 각 타입의 코드 값을 다룹니다.

에러 브릿지 — 소스클립 플레이어
예상 소요 시간: 10분
🔧 필수/선택: 선택 — 정의하지 않으면 플레이어 안에서만 표시
sauceclipPlayerError

세 필드가 함께 전달됩니다.

필드타입설명
errorCodeString타입별 코드. 아래 표 참조
errorDetailsString에러 상세. API 에러는 JSON 문자열
errorTypeString'api' · 'ui' · 'video'
javascript
window.sauceclipPlayerError = function (params) {
  console.error(params.errorType, params.errorCode, params.errorDetails)
}

에러 타입
errorType발생 시점errorCodeerrorDetails
'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)

Did this page help you?
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇 BETA
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.