GuidesAPI GuideChangelog
Log In
Guides

1. SDK 설치하기

프로젝트에 SDK 를 추가하고 AppDelegate 에서 한 번 초기화합니다. 연동하는 동안에는 테스트 서버(.stage)를 쓰고, 실제 서비스로 내보낼 때 .prod 로 바꿉니다.

1. SDK 설치하기 — 소스라이브 플레이어 iOS SDK
예상 소요 시간: 15분
📋 사전 조건: 시작하기 전에 — 활성화 키 발급
SDK 추가하기

프로젝트에 SDK 를 내려받도록 설정합니다. Swift Package Manager 와 CocoaPods 를 지원합니다.

배포 준비 중

소스라이브 플레이어 앱SDK 는 배포를 준비하고 있습니다.
저장소 주소와 패키지 이름이 확정되면 이 자리에 게시됩니다. 먼저 사용해야 한다면 담당자에게 문의해 주세요.

💡 그동안 확인할 수 있는 것 — 아래 초기화 코드와 동작 확인 방법은 배포 여부와 무관하게 동일합니다. 미리 읽어 두면 SDK 가 준비된 뒤 바로 연동할 수 있습니다.
초기화하기

앱이 시작될 때 한 번만 초기화합니다.
AppDelegatedidFinishLaunchingWithOptions 가 가장 적절한 위치입니다.

Swift
import SauceSDK

func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    SauceClient.initInstance(
        activationKey: "발급받은 활성화 키",
        apiHost: .stage  // 테스트 환경. 실제 서비스에서는 .prod
    )
    return true
}
파라미터타입필수설명
activationKeyString필수담당자에게 발급받은 활성화 키.
이 키로 파트너와 사용 가능한 기능이 결정됩니다
apiHostAPIHost선택.stage(테스트) 또는 .prod(운영).
생략하면 .stage 입니다
⚠️ 두 플랫폼의 기본값이 반대입니다. iOS 는 생략하면 .stage(테스트), Android 는 생략하면 운영입니다. 두 플랫폼을 함께 연동한다면 각각 환경을 명시하는 편이 안전합니다.
제대로 되었는지 확인하기

초기화 결과는 Xcode 콘솔에 출력됩니다. 예외가 발생하지 않으므로 로그로 확인하세요.

  • 1
    앱을 실행하고 Xcode 콘솔에서 SauceClient 초기화 로 시작하는 로그를 찾습니다.
    활성화 키 인증 성공 메시지와 함께 파트너 ID·사용 가능한 기능이 출력되면 정상입니다.
  • 2
    코드로 확인하려면 SauceClient.isInitializedSauceClient.isLiveEnabled() 를 사용합니다.
  • 3
    2. 플레이어 실행하기 로 넘어가 실제로 화면이 뜨는지 확인합니다.
⚠️ 인증이 실패해도 예외가 발생하지 않습니다. 콘솔에 실패 메시지만 남습니다. 플레이어가 뜨지 않으면 먼저 이 로그를 확인하세요.


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

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

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