Error codes

Error codes — 소스라이브 플레이어 Android SDK

📘 레퍼런스

📡 onError 로 전달

오류가 오는 곳

오류는 onError 콜백으로 전달되고, 로그에도 남습니다.
콜백을 등록하지 않으면 로그만 남습니다.

항목	내용
전달값	`error.code` — 숫자 `error.message` — 원인 설명
로그 위치	Android Logcat 의 `SauceLive` 태그

Kotlin

override fun onError(error: SdkError) {
    Log.w("MyApp", "SauceLive error ${error.code}: ${error.message}")
}

📘 등록 방법은 다른 콜백과 같습니다. 전체 목록은 Event handler 에 있습니다.

코드 목록

만 단위가 그룹입니다.
개별 원인을 특정할 수 없으면 그룹 번호(10000 · 20000 …)로 옵니다.

코드	언제 발생하나	플레이어	앱이 할 일
10000 — 초기화 · appKey
`10001`	appKey 가 비어 있거나 형식이 잘못됨	실행되지 않음	초기화 코드의 appKey 값 확인
`10002`	appKey 를 사용할 수 없음 — 발급되지 않았거나 해지됨. 다른 환경(테스트/운영)의 키를 넣은 경우도 포함	실행되지 않음 사용 중 해지되면 닫힘	환경에 맞는 키인지 확인 후 담당자 문의
`10003`	appKey 에 라이브 기능 권한이 없음	실행되지 않음	담당자 문의
`10004`	초기화 전에 플레이어를 실행함	실행되지 않음	`init()` 를 먼저 호출
20000 — 방송
`20001`	방송 정보를 받지 못함 (네트워크·서버 오류)	닫힘	네트워크 확인 후 다시 실행
`20002`	존재하지 않는 라이브 ID	닫힘	어드민에서 라이브 ID 확인
`20003`	방송 설정을 받지 못함	닫힘	네트워크 확인 후 다시 실행
`20004`	비밀번호 방송 — 취소했거나 비밀번호가 맞지 않음	닫힘	없음 (시청자 동작)
30000 — 사용자
`30001`	사용자 토큰 검증 실패 — 게스트로 진행됨	유지	토큰 발급 시점·대상 파트너 확인. 회원으로 바꾸려면 `updateAccessToken`
`30002`	게스트 계정을 발급받지 못함	닫힘	네트워크 확인 후 다시 실행
40000 — 재생
`40001`	영상 재생 오류	유지 — 자동 재시도	없음
`40002`	네트워크 끊김	유지 — 자동 재연결	없음
50000 — 채팅
`50001`	채팅 서버 연결 실패	유지 — 자동 재연결	없음
`50002`	채팅 입장 실패 (닉네임 중복 등)	유지	없음 (플레이어가 안내 표시)
60000 — 기능
`60001`	쿠폰 발급 실패 (`apiDownload` 타입)	유지	자사 발급 API 응답 확인
`60002`	이벤트 참여 실패	유지	없음 (플레이어가 안내 표시)
`60003`	알림 신청·해제 실패	유지	없음 (플레이어가 안내 표시)

📘 「플레이어」 열이 「닫힘」인 오류는 onError 뒤에 onClose 가 이어서 호출됩니다. 닫힘 사유는 UNAVAILABLE 입니다.

목록에 없는 오류라면

아래를 정리해 전달해 주시면 원인 확인이 빠릅니다.

항목	왜 필요한가
오류 코드 · 메시지	`onError` 로 받은 값 그대로
라이브 ID	어느 방송인지 특정합니다
Logcat 로그	SDK 가 남긴 메시지를 확인합니다
발생 시각 · 기기 · Android 버전	서버 로그와 대조합니다

📘 문의 경로 — 모비두 담당자 또는 카카오톡 채널

처음으로

🤖 Android — 연동 전체 과정 다시 보기

→