시작하기 전에

시작하기 전에 — 소스라이브 플레이어 iOS SDK

⏱ 예상 소요 시간: 5분 (읽기만)

📋 사전 조건: 없음 — 가장 먼저 읽는 페이지입니다

개발 환경

아래 사양을 충족하는지 먼저 확인하세요.

항목	요구 사양	비고
배포 타깃	iOS 13.0 이상	SDK 가 요구하는 최소 버전입니다
Swift 언어 모드	Swift 5	Swift 6 모드 프로젝트에서도 사용할 수 있습니다
배포 형식	`.xcframework`	Swift Package Manager · CocoaPods 로 추가합니다

💡 Xcode 버전은 따로 요구하지 않습니다. SDK 는 라이브러리 진화(library evolution)를 켜고 빌드되어 있어, 위 배포 방식을 지원하는 Xcode 라면 컴파일러 버전이 달라도 사용할 수 있습니다.

플레이어가 화면에 붙는 방식

코드 작성 전에 알아 둘 구조입니다.
iOS SDK 는 새 화면을 띄우지 않습니다. 앱이 준 화면 안에 자식으로 들어갑니다.

1

앱이 컨테이너 UIViewController 를 준비합니다.
플레이어를 전체 화면으로 보여 줄 화면이며, 새 화면과 기존 화면 모두 사용할 수 있습니다.
2

라이브 ID — 재생할 방송을 지정하는 값입니다.
라이브를 편성한 뒤 라이브 송출 정보 확인에서 값을 복사해 코드에 직접 넣습니다.

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

⚠️ 키가 정상 발급되었는지 확인하세요 — 활성화 키 검증에 실패하면 오류가 던져지지 않고 로그만 남습니다. 원인 특정이 어려우므로, 플레이어 실행까지 확인한 뒤 다음 단계로 진행하면 문제 범위를 좁힐 수 있습니다.

💡 Android 와 이름이 다릅니다 — Android SDK 는 같은 역할의 값을 파트너 토큰이라고 부릅니다. 두 플랫폼을 함께 연동한다면 발급받을 때 어느 쪽 값인지 확인하세요.

💡 발급 문의 — 모비두 담당자 또는 카카오톡 채널로 요청하세요.

⚠️ 실제 서비스에서는 라이브 ID 를 코드에 넣지 않습니다. 방송은 계속 새로 편성되므로, 앱을 다시 배포해야 하는 구조가 됩니다. 방송 목록 조회 API 로 그때그때 받아 오세요.

실제 서비스에서는 API 로 받아 옵니다

자사 서버나 앱이 소스라이브 API 를 호출해 지금 방송 중인 라이브 ID 를 받아 플레이어에 넘깁니다.
두 가지 API 가 있고 쓰는 화면이 다릅니다.

API	용도	어느 화면에 쓰나
최신 라이브 · VOD 조회 `GET /V1/front/broadcast`	가장 최근 방송의 `broadcastId` · 방송명 · 종류(라이브/VOD) · 상태 · 썸네일	플레이어를 띄우는 화면 「지금 방송 보기」 버튼, 홈 배너
예정 라이브 조회 `GET /V1/front/broadcast/schedule`	예정된 방송 목록의 `broadcastId` · 편성 시작·종료 시각 · 방송명	편성표·예고 화면 알림 신청, 방송 목록

💡 둘 다 partnerId 하나로 호출합니다 — 별도 인증 토큰이 필요하지 않습니다. 파트너 ID 는 활성화 키 을 발급받을 때 함께 안내받습니다.

💡 어디서 호출하는 게 좋은가 — 자사 서버를 거치는 것을 권합니다. 앱에서 직접 호출해도 동작하지만, 서버에서 받아 두면 편성 정책·노출 조건을 앱 배포 없이 바꿀 수 있습니다.

💡 전체 규격은 API 문서에서 — 응답 필드·검색 파라미터·페이지네이션은 API 레퍼런스에 정리되어 있습니다.