1. SDK 설치하기

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

⏱ 예상 소요 시간: 15분

📋 사전 조건: 시작하기 전에 — appKey 발급

SDK 추가하기

SDK 는 Maven Central 에 배포되어 있습니다.
저장소와 의존성 두 곳을 설정합니다.

settings.gradle.kts — 저장소

dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

build.gradle.kts (app) — 의존성

dependencies {
    implementation("io.github.mobidoo-official:Sauce:1.0.1")
}

항목	값
저장소	Maven Central — 별도 인증이 필요하지 않습니다
그룹	`io.github.mobidoo-official`
아티팩트	`Sauce`
현재 버전	`1.0.1`

초기화하기

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

Kotlin

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

        SauceClient.init(
            context     = this,
            appKey      = "발급받은 appKey",
            environment = "stage"    // 테스트 환경. 실제 서비스에서는 "prod"
        )
    }
}

파라미터	타입	필수	설명
`context`	`Context`	필수	`Application` 인스턴스를 전달합니다
`appKey`	`String`	필수	담당자에게 발급받은 appKey. 환경별로 다릅니다
`environment`	`String`	선택	`"stage"`(테스트) 또는 `"prod"`(운영). 생략하면 운영입니다

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

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

Application 클래스 등록

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

XML

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

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

제대로 되었는지 확인하기

초기화는 성공해도 아무 표시가 없습니다. 실패해도 예외를 던지지 않고 onError 와 로그로만 알립니다.

1

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

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

⚠️ appKey 가 잘못되어도 앱은 정상 실행됩니다. 초기화 실패는 예외를 던지지 않고 onError(10001~10003)와 로그로만 알리며, 플레이어를 실행할 때가 되어서야 아무 일도 일어나지 않는 형태로 드러납니다. 다음 단계까지 반드시 확인하세요. → Error codes

다음 단계

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

→