1. SDK 설치하기

1. SDK 설치하기 — 소스라이브 플레이어 Android SDK

⏱ 예상 소요 시간: 15분

📋 사전 조건: 시작하기 전에 — 파트너 토큰 발급

SDK 추가하기

프로젝트에 SDK 를 내려받도록 설정합니다.

배포 준비 중

소스라이브 플레이어 앱SDK 는 배포를 준비하고 있습니다.
저장소 주소와 라이브러리 좌표가 확정되면 이 자리에 게시됩니다. 먼저 사용해야 한다면 담당자에게 문의해 주세요.

💡 그동안 확인할 수 있는 것 — 아래 초기화 코드와 동작 확인 방법은 배포 여부와 무관하게 동일합니다. 미리 읽어 두면 SDK 가 준비된 뒤 바로 연동할 수 있습니다.

초기화하기

앱이 시작될 때 한 번만 초기화합니다.
Application 클래스가 없다면 새로 만들고 AndroidManifest.xml 에 등록하세요.

Kotlin

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        SauceClient.init(
            context      = this,
            partnerToken = "발급받은 파트너 토큰",
            stageMode    = true    // 테스트 환경. 실제 서비스에서는 false
        )
    }
}

파라미터	타입	필수	설명
`context`	`Context`	필수	`Application` 인스턴스를 전달합니다
`partnerToken`	`String`	필수	담당자에게 발급받은 파트너 토큰
`stageMode`	`Boolean`	선택	`true` 면 테스트 환경. 생략하거나 `false` 면 운영 환경입니다

⚠️ Activity 에서 호출하지 마세요 — 화면을 다시 만들 때마다 재실행되어 예기치 않게 동작할 수 있습니다. 반드시 Application 의 onCreate() 에서 한 번만 호출하세요.

💡 생략하면 운영 환경입니다. 연동하는 동안에는 stageMode = true 로 테스트 서버를 쓰고, 실제 서비스로 내보낼 때 false 로 바꾸세요.

Application 클래스 등록

새로 만든 Application 클래스를 AndroidManifest.xml 에 등록합니다.
이미 Application 클래스를 쓰고 있다면 초기화 코드만 추가합니다.

XML

<application
    android:name=".MyApplication"
    ... >
</application>

✅ 그 외 Manifest 작업은 없습니다. 플레이어 화면·권한·PIP 지원 선언은 SDK 에 이미 포함되어 있습니다. 자세히 보기

제대로 되었는지 확인하기

초기화는 성공해도 아무 표시가 없습니다. 실패해도 예외가 발생하지 않으므로 다음 단계에서 확인하세요.

1

앱을 실행하고 Logcat 에서 SauceClient 태그를 확인합니다. 오류 메시지가 없으면 정상입니다.
2

2. 플레이어 실행하기로 넘어가 실제로 플레이어가 뜨는지 확인합니다. 이것이 가장 확실한 검증입니다.

⚠️ 토큰이 잘못되어도 앱은 정상 실행됩니다. 초기화 실패는 로그로만 남고, 플레이어를 실행할 때가 되어서야 아무 일도 일어나지 않는 형태로 드러납니다. 원인을 찾기 어려우므로 다음 단계까지 반드시 확인하세요.

다음 단계

▶️ 2. 플레이어 실행하기 — 라이브 ID 하나로 첫 실행

→