시작하기 전에

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

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

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

개발 환경

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

💡 Android Studio · Gradle 버전 — 별도로 요구하는 버전은 없으며, 위 SDK 버전을 컴파일할 수 있는 환경이면 사용할 수 있습니다.

준비물 두 가지

연동을 시작하려면 아래 두 가지가 필요합니다.
둘 다 코드로 만들 수 없고, 발급받거나 확인해야 하는 값입니다.

1

파트너 토큰 — 모비두 담당자에게 발급받습니다.
앱을 시작할 때 SDK 를 초기화하는 데 사용하며, 이 토큰으로 파트너가 식별됩니다.
2

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

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

⚠️ 토큰이 정상 발급되었는지 확인하세요 — 토큰이 유효하지 않으면 플레이어가 오류 없이 조용히 실행되지 않습니다. 원인 특정이 어려우므로, 플레이어 실행까지 확인한 뒤 다음 단계로 진행하면 문제 범위를 좁힐 수 있습니다.

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

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

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

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

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

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

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

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