GuidesAPI GuideChangelog
Log In
Guides

1. SDK 설치하기

프로젝트에 SDK 를 추가하고 AppDelegate 에서 한 번 초기화합니다. apiHost 를 생략하면 운영(.prod)이므로, 연동하는 동안에는 .stage 를 명시합니다.

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

Swift Package Manager 와 CocoaPods 를 지원합니다.
둘 중 프로젝트가 쓰는 방식 하나만 설정하면 됩니다.

Swift Package Manager — Package.swift
.package(
    url: "https://github.com/mobidoo-official/SauceSDK_iOS-Binary",
    from: "1.0.2"
)
📘 Xcode 에서 추가할 때File > Add Package Dependencies… 에 위 저장소 주소를 붙여 넣습니다.
CocoaPods — Podfile
pod 'SauceSDK', '1.0.2'
항목
배포 형식바이너리 .xcframework별도 인증이 필요하지 않습니다
SPM 저장소mobidoo-official/SauceSDK_iOS-Binary
Pod 이름SauceSDK
현재 버전1.0.2
📘 버전을 고정하는 범위가 다릅니다. 위 SPM 설정의 from: "1.0.2"1.x 업데이트를 받아들이고, Podfile 의 '1.0.2'그 버전에 고정합니다. 정책에 맞게 조정하세요.
초기화하기

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

Swift
import SauceSDK

func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
    SauceClient.initInstance(
        appKey: "발급받은 appKey",
        apiHost: .stage  // 테스트 환경. 실제 서비스에서는 .prod
    )
    return true
}
파라미터타입필수설명
appKeyString필수담당자에게 발급받은 appKey. 환경별로 다릅니다
apiHostAPIHost선택.stage(테스트) 또는 .prod(운영).
생략하면 .prod(운영)입니다
📘 생략하면 운영 환경입니다. 연동하는 동안에는 apiHost: .stage 로 테스트 서버를 쓰고, 실제 서비스로 내보낼 때 .prod 로 바꾸세요.
제대로 되었는지 확인하기

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

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


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

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

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