GuidesAPI GuideChangelog
Log In
Guides

3. 사용자 인증하기

getInstance 에 사용자 토큰을 넘기면 회원으로, 넘기지 않으면 게스트로 시청합니다. 토큰이 거부되어도 재생은 멈추지 않으므로 확인 방법을 함께 다룹니다.

3. 사용자 인증하기 — 소스라이브 플레이어 iOS SDK
예상 소요 시간: 10~30분
📋 사전 조건: 2. 플레이어 실행하기
게스트와 회원, 두 가지 상태

인증 방식은 한 가지로, getInstancetoken 을 넘기는지 여부로 결정됩니다.
판단할 것은 회원 기능 필요 여부 하나입니다.

게스트회원
tokennil 로 두거나 생략발급받은 사용자 토큰 전달
시청가능가능
채팅닉네임을 입력하면 가능
4. 채팅 사용하기
회원 닉네임으로 바로 가능
쿠폰·이벤트 참여제한됩니다가능
시청 이력·통계단말 기준으로만 남습니다회원 기준으로 남습니다
게스트 계정 자동 발급

token 을 넘기지 않아도 아무 인증 없이 동작하는 것이 아닙니다.
SDK 가 임시 계정을 자동으로 발급받아 단말에 보관합니다.

  • 1
    SDK 가 임시 닉네임을 만들어 게스트 토큰을 발급받습니다.
  • 2
    발급된 토큰을 단말에 저장합니다. 같은 앱에서 다시 시청하면 그 계정을 재사용합니다.
  • 3
    앱이 할 일은 없습니다. 발급·보관·재사용이 모두 SDK 안에서 일어납니다.
📘 웹 SDK 의 게스트와 다릅니다 — 웹은 게스트가 식별자 없이 동작하지만, 앱은 임시 계정을 발급받습니다. 채팅 참여는 이 계정을 쓰며, 방송 설정에서 게스트 채팅을 허용한 경우에만 동작합니다.
회원으로 연결하기

앞 단계에서 nil 로 두었던 token 자리에 발급받은 사용자 토큰을 넣습니다.

Swift
let player = SauceLivePlayerClient.getInstance(
    broadcastID: "라이브 ID",
    token: "발급받은 사용자 토큰",   // ← 이 값만 추가하면 회원 시청
    viewController: self
)
player.startPlayer()
📘 토큰은 어디서 받나요자사 백엔드가 소스라이브 규격으로 만들어 앱에 내려 줍니다. 앱이 직접 발급받는 경로는 제공되지 않습니다. 생성 규격은 JWT 토큰 생성 가이드에 있습니다.
토큰 거부 시 동작

가장 주의할 동작입니다.
토큰이 잘못되어도 플레이어는 그대로 실행됩니다. 시청자만 게스트가 됩니다.

⚠️ 재생이 멈추지 않아 놓치기 쉽습니다. 토큰 거부는 onError코드 30001 이 오지만 플레이어는 유지됩니다. 콜백을 등록하지 않았다면 플레이어 안에 표시되는 닉네임으로 확인하세요. 회원 닉네임이 아니라 임시 닉네임이 보이면 토큰이 거부된 것입니다. → Error codes
증상확인할 것
임시 닉네임이 보인다토큰이 만료되었거나 다른 파트너의 토큰일 수 있습니다. 발급 시점과 대상 파트너를 확인하세요
회원 기능이 제한된다같은 원인입니다. 게스트로 시청 중이므로 쿠폰·이벤트 참여가 막힙니다
로그인이 필요한 순간 처리하기

게스트가 회원 전용 기능을 누르면 플레이어가 「로그인 하시겠습니까?」 를 띄웁니다.
시청자가 「로그인」 을 선택하면 onLoginRequest 가 호출됩니다 — 이때 앱이 자기 로그인 화면을 열어야 합니다.

Swift
extension AppDelegate: LivePlayerCallback {
    func onLoginRequest(context: LoginRequestContext) {
        // context.feature  = 로그인을 요구한 기능 (.chat .coupon .reward .wish .event .notification)
        // context.resumeId = 로그인 후 이어서 처리할 대상 ID. 없으면 nil
        presentLoginScreen { newToken in
            SauceClient.updateAccessToken(newToken)   // 플레이어가 열린 채로 회원으로 전환됩니다
        }
    }
}
📘 플레이어는 열린 채로 유지됩니다. 로그인이 끝나면 SauceClient.updateAccessToken(token) 을 호출하세요. 재생을 유지한 채 회원으로 전환됩니다.
⚠️ onLoginRequest 를 등록하지 않으면 시청자가 「로그인」 을 눌러도 아무 일도 일어나지 않습니다. 게스트 시청을 허용한다면 반드시 등록하세요.


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

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

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