F. 딥링크 연동하기

F. 딥링크 연동하기 — 소스라이브 플레이어 Android SDK

⏱ 예상 소요 시간: 10분

앱이 하는 일과 SDK 가 하는 일

딥링크로 방송에 바로 들어오게 하려면 두 가지가 필요합니다.
SDK 가 제공하는 딥링크 전용 기능은 없습니다. 앱이 링크를 받아 라이브 ID 를 꺼낸 뒤, 2. 플레이어 실행하기 와 같은 방법으로 startLivePlayer() 를 호출합니다.

1. 링크 주소 정하기

고객사 앱의 App Scheme 또는 App Link 를 등록해 특정 링크로 플레이어를 실행합니다.
예를 들어 이런 형태를 쓸 수 있습니다.

URI

myapp://live?broadcastId=123456

구성	역할
`myapp`	고객사에서 사용하는 App Scheme. 앱 환경에 맞게 정의합니다
`live`	라이브 방송 진입을 구분하기 위한 Host
`broadcastId`	실행할 라이브 방송 ID

📌 배포용 링크 주소 체계는 먼저 확인하세요 — 어떤 도메인·경로로 방송 링크를 내보낼지는 서비스마다 다릅니다. 담당자에게 확인한 뒤 등록하세요.

2. AndroidManifest.xml 에 등록하기

딥링크를 전달받을 Activity 에 intent-filter 를 추가합니다.

XML

<activity
    android:name=".DeepLinkActivity"
    android:exported="true">

    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="myapp"
            android:host="live" />
    </intent-filter>

</activity>

💡 이것은 앱 자신의 Activity 설정입니다. SDK 를 쓰기 위한 선언이 아닙니다. SDK 가 필요로 하는 Manifest 선언은 이미 SDK 안에 포함돼 있어 따로 추가할 것이 없습니다.

3. 라이브 ID 를 꺼내 실행하기

등록한 Activity 에서 전달받은 URI 의 broadcastId 를 추출한 뒤 startLivePlayer() 를 호출합니다.

Kotlin

class DeepLinkActivity : AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        handleDeepLink(intent)
    }

    private fun handleDeepLink(intent: Intent?) {
        val uri = intent?.data
        val broadcastId = uri?.getQueryParameter("broadcastId")

        if (broadcastId.isNullOrBlank()) {
            finish()
            return
        }

        SauceClient.startLivePlayer(
            context     = this,
            broadcastId = broadcastId,
            token       = null
        )

        finish()
    }
}

💡 회원으로 진입시키려면 — 앱에서 로그인한 사용자의 토큰을 조회해 token 에 함께 전달하세요. 넘기지 않으면 게스트로 시청합니다. → 3. 사용자 인증하기

다음 단계

⚙️ 고급 설정 — 세부 동작 조정하기

→