GuidesAPI GuideChangelog
Log In
Guides

F. 딥링크 연동하기

링크를 눌러 앱이 열렸을 때 해당 방송으로 바로 들어가게 합니다. 라이브 ID 를 꺼낸 뒤 컨테이너 화면을 만들어 getInstance 로 실행하는 흐름입니다.

F. 딥링크 연동하기 — 소스라이브 플레이어 iOS SDK
예상 소요 시간: 10분
📋 사전 조건: 2. 플레이어 실행하기
앱이 하는 일과 SDK 가 하는 일

딥링크로 방송에 바로 들어오게 하려면 두 가지가 필요합니다.
링크로 앱이 열리게 하는 것은 앱 쪽 작업이고, 라이브 ID 를 꺼낸 뒤에는 플레이어를 담을 화면을 만들어 넘기는 것까지 앱이 합니다. 실행 방식은 2. 플레이어 실행하기 와 같습니다.

링크에서 라이브 ID 를 꺼내 실행하기
Swift
// 유니버설 링크·URL 스킴으로 앱이 열렸을 때
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    guard let url = userActivity.webpageURL,
          let broadcastID = SauceClient.extractBroadcastId(from: url) else { return }

    // 플레이어를 담을 빈 컨테이너를 먼저 띄운다
    let container = UIViewController()
    container.modalPresentationStyle = .fullScreen
    topViewController()?.present(container, animated: true)

    let player = SauceLivePlayerClient.getInstance(
        broadcastID: broadcastID,
        token: nil,          // 회원으로 진입시키려면 사용자 토큰
        viewController: container
    )

    // 콜백을 먼저 등록한 뒤 startPlayer() 를 호출합니다
    player.onClose = { [weak container] in
        container?.dismiss(animated: true)
    }

    player.startPlayer()
}
⚠️ 플레이어 인스턴스를 붙잡아 두세요 — 위 player 는 함수가 끝나면 참조가 사라집니다. 2. 플레이어 실행하기 처럼 화면이 살아 있는 동안 유지되는 프로퍼티에 보관하세요.
💡 링크 등록은 앱 쪽 작업입니다. 어떤 주소로 앱이 열리게 할지는 유니버설 링크 또는 URL 스킴 설정으로 정합니다. SDK 에는 딥링크 전용 진입점이 따로 없고, 꺼낸 라이브 ID 로 평소와 같이 플레이어를 실행합니다.
📌 배포용 링크 주소 체계는 먼저 확인하세요 — 어떤 도메인·경로로 방송 링크를 내보낼지는 서비스마다 다릅니다. 담당자에게 확인한 뒤 유니버설 링크를 등록하세요.


Did this page help you?
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇 BETA
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.