3. 사용자 인증하기

인증은 토큰을 넘기는지 여부 하나로 갈립니다.
토큰을 넘기지 않으면 게스트 모드로 실행되며, 회원 전용 기능만 제한됩니다.

토큰을 넘기지 않으면 SDK 가 임시 계정을 서버에서 발급받아 사용합니다.
발급된 토큰은 기기에 저장되어 다음 실행에 재사용됩니다.

• 1
  토큰을 넘기지 않은 상태로 플레이어를 실행하면, 기기에 저장된 게스트 토큰이 있는지 확인합니다.
• 2
  없으면 GUEST + 10자리 난수 닉네임으로 임시 계정을 발급받습니다.
• 3
  발급된 토큰을 기기에 저장합니다. 다음 실행에서는 같은 게스트로 인식됩니다.

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

SauceClient.startLivePlayer(
    context     = this,
    broadcastId = "라이브 ID",
    token       = userAccessToken   // 자사 로그인 사용자의 토큰
)

앱이 소스라이브에 직접 토큰을 요청하는 방법은 제공되지 않습니다.
자사 백엔드가 토큰을 만들어 앱에 내려 주는 구조가 유일한 경로입니다.

• 1
  사용자가 앱에 로그인하면 자사 서버가 회원을 확인합니다.
• 2
  자사 서버가 소스라이브 규격으로 토큰을 만들어 앱에 응답합니다.
  닉네임·회원 식별자·회원 구분 같은 정보를 토큰 안에 담습니다.
• 3
  앱은 받은 토큰을 startLivePlayer() 의 token 에 그대로 전달합니다.
  앱의 역할은 전달까지입니다. 토큰을 해석하거나 가공하지 않습니다.

전달한 토큰이 유효하지 않으면 오류를 표시하지 않고 게스트 계정으로 대체합니다.
플레이어는 정상적으로 재생되므로, 로그인했는데 게스트로 보이는 상황이 생길 수 있습니다.

게스트 참여가 허용되지 않은 방송에서 게스트가 채팅을 시도하면, 플레이어가 로그인 안내를 표시한 뒤 앱에 알려 줍니다.
이때 앱의 로그인 화면으로 보내고, 완료 후 플레이어를 다시 시작합니다.

SauceClient.setLivePlayerCallbackListener(object : LivePlayerCallbackListener {
    override fun onLoginRequest() {
        // 앱의 로그인 화면으로 이동
        // 로그인 완료 후 startLivePlayer() 를 다시 호출해 토큰을 전달합니다
    }

    // 아래 세 개는 각 기능 페이지에서 다룹니다 (인터페이스라 선언은 필요합니다)
    override fun onCouponDownload(couponCode: String) {}
    override fun onCouponCustom(couponData: String) {}
    override fun onCart(productId: String) {}
})