2. 플레이어 실행하기

iOS SDK 는 새 화면을 띄우지 않습니다. 컨테이너 화면(UIViewController)을 넘기면 플레이어가 그 안에 자식으로 들어갑니다.
콜백은 Event handler 의 SauceClient.setLivePlayerCallback 으로 앱 전체에 한 번 등록합니다.

SauceClient.startLivePlayer(broadcastID: "라이브 ID", token: nil, from: self)

플레이어별로 다른 콜백을 주거나 closePlayer() 로 직접 닫으려면 아래처럼 인스턴스를 만듭니다.

import SauceSDK

class LivePlayerVC: UIViewController {

    private var player: SauceLivePlayerClient?

    override func viewDidLoad() {
        super.viewDidLoad()

        let player = SauceLivePlayerClient.getInstance(
            broadcastID: "라이브 ID",
            token: nil,          // 게스트 모드 — 회원 연동은 다음 단계에서
            viewController: self
        )

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

        player.startPlayer()
        self.player = player
    }
}

호출 두 개로 끝나지만, 내부에서는 아래 순서로 진행됩니다.
화면이 뜨지 않을 때 어디까지 진행됐는지 가늠하는 데 도움이 됩니다.

• 1
  getInstance 가 SDK 초기화 상태와 라이브 사용 권한을 확인합니다. 초기화가 안 됐거나 라이브 기능이 비활성이면 여기서 중단됩니다.
• 2
  startPlayer 가 플레이어를 컨테이너의 자식 화면으로 추가하고 컨테이너 크기를 그대로 채웁니다.
• 3
  토큰을 확인합니다. nil 이면 게스트 계정을 자동 발급받습니다.
• 4
  방송 정보를 받아 영상·채팅·상품 목록을 구성합니다. 이 단계에서 실패하면 시청자 화면에 오류가 표시되고 콘솔에 로그가 남습니다.

시청자가 플레이어의 닫기 버튼을 누르면 onClose 가 호출됩니다.
화면을 내리는 것은 앱이 해야 합니다. SDK 는 자기 자신만 정리합니다.

순서대로 확인하세요. 대부분 앞의 두 가지입니다.
onError 를 등록해 두면 원인이 코드로 옵니다 — Error codes.

라이브 ID 는 소스 어드민에서 확인합니다.
라이브를 편성한 뒤 라이브 송출 정보 확인에서 값을 복사해 broadcastId 에 그대로 전달하세요.

▲ 어드민 분석 > 라이브 > 상세 > 송출정보에서 라이브 ID를 확인·복사