Error codes

SDK 가 앱에 알리는 오류는 appKey 검증 실패 하나이고 onSdkAuthFailed 로 옵니다. 코드별 원인과 앱이 할 일, 알리지 않거나 앱이 종료되는 경우를 함께 다룹니다.

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

📘 레퍼런스

📡 onSdkAuthFailed 로 전달

오류가 오는 곳

SDK 가 앱에 알리는 오류는 appKey 검증 실패 하나이고, 앱 전체 콜백의 onSdkAuthFailed 로 옵니다.
숫자 오류 코드는 없습니다. player.onError 와 SwiftUI onSauceError 는 선언만 있고 호출되지 않습니다.

항목	내용
전달값	`code` — 문자열 코드 `message` — 원인 설명
받는 곳	`SauceClient.setLivePlayerCallback(_:)` 에 넘긴 객체. 인스턴스별 클로저로는 받을 수 없습니다
등록하지 않으면	아무 동작 없음. 로그도 남지 않습니다

Swift

// SauceClient.setLivePlayerCallback(_:) 에 넘긴 객체에 구현합니다
func onSdkAuthFailed(code: String, message: String) {
    print("SauceLive appKey 오류 \(code): \(message)")
}

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

코드 목록

코드는 서버가 정한 값을 그대로 전달합니다.
서버가 코드를 주지 않으면 아래 두 코드 중 하나로 채웁니다.

코드	언제 발생하나	그 뒤 플레이어	앱이 할 일
`SDK001`	서버가 appKey 를 받아들이지 않음 — 발급되지 않았거나 쓸 수 없는 키	이번 앱 실행 동안 열리지 않음. `startPlayer()` 를 부를 때마다 이 코드가 다시 옵니다. 다음 실행 때 다시 검증	환경(`.stage` · `.prod`)에 맞는 키인지 확인한 뒤 담당자 문의
`C001`	서버가 검증 요청을 잘못된 요청으로 판단함	이번 앱 실행 동안 열리지 않음. 다음 실행 때 다시 검증	초기화 코드에 appKey 가 제대로 들어갔는지 확인
`C001`	실행할 때 파트너 식별자를 확인할 수 없음 — 첫 검증이 네트워크 오류로 끝났고, 라이브 ID 로도 파트너를 알 수 없음	이번 실행만 열리지 않음	네트워크를 확인하고 다시 실행. 라이브 ID 가 맞는지 확인

알리지 않거나 앱이 종료되는 경우

아래 경우에는 onSdkAuthFailed 가 오지 않습니다.

상황	플레이어	확인 방법
`initInstance` 전에 `getInstance` 를 부름	앱이 종료됨	`SauceClient.isInitialized` 로 먼저 확인
회원 토큰 검증에 실패함	게스트로 진행	플레이어에 회원 닉네임이 표시되는지 확인 → 3. 사용자 인증하기

담당자에게 문의할 때

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

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

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

처음으로

🍎 iOS — 연동 전체 과정 다시 보기

→

Updated 2 days ago

Did this page help you?