2. 플레이어 실행하기

준비물은 라이브 ID 하나입니다.
토큰을 넘기지 않으면 게스트 모드로 실행되므로, 회원 연동 없이 먼저 화면을 확인할 수 있습니다.

SauceClient.startLivePlayer(
    context     = this,
    broadcastId = "라이브 ID",
    token       = null   // 게스트 모드 — 회원 연동은 다음 단계에서
)

플레이어 화면을 띄우는 데 필요한 Activity 선언과 권한은 SDK 가 자체 Manifest 에 이미 포함하고 있습니다.
Gradle 의 Manifest 병합이 앱 Manifest 로 자동 반영하므로, 앱에서 따로 추가할 것이 없습니다.

플레이어가 뜨지 않을 때 어느 단계에서 멈췄는지 이 순서로 짚을 수 있습니다.

• 1
  초기화 — 앱 시작 시 호출한 SauceClient.init() 이 appKey 를 검증하고 플레이어를 사용할 준비를 합니다. appKey 검증에 실패하면 이후 단계가 진행되지 않습니다.
• 2
  실행 요청 — startLivePlayer() 가 초기화가 끝났는지 확인합니다. 준비되지 않았으면 예외를 던지지 않고 onError 로 10004 를 보낸 뒤 종료합니다.
• 3
  화면 전환 — 플레이어 Activity 가 시작됩니다. 라이브 ID 와 토큰은 Intent 로 전달됩니다.
• 4
  설정 조회 후 구성 — Activity 가 서버에서 방송 설정을 받아 플레이어 UI 를 구성합니다. 플레이어의 색상·로고·기능 노출은 이 설정을 따릅니다. 자세한 내용은 고급 설정에 있습니다.

플레이어가 닫히면 onClose 로 닫힌 이유가 전달됩니다.
Android 는 플레이어가 별도 Activity 라 화면 정리는 SDK 가 하지만, 이유에 따라 앱이 할 일이 다릅니다.

override fun onClose(reason: PlayerCloseReason) {
    when (reason) {
        PlayerCloseReason.USER        -> { // 시청자가 닫음 — 보통 할 일 없음 }
        PlayerCloseReason.SYSTEM      -> { // 시스템이 닫음 }
        PlayerCloseReason.UNAVAILABLE -> { // 방송을 열 수 없음 — 안내 후 목록으로 }
    }
}

이 SDK 는 초기화가 되지 않았을 때 예외를 던지지 않고 조용히 종료합니다.
화면이 그대로라면 onError 와 Logcat 을 먼저 확인하세요. 코드별 원인은 Error codes 에 있습니다.

라이브 ID 는 소스 어드민에서 확인합니다.
라이브를 편성한 뒤 라이브 송출 정보 확인에서 값을 복사해 broadcastId 에 그대로 전달하세요.

▲ 어드민 분석 > 라이브 > 상세 > 송출정보에서 라이브 ID를 확인·복사