Universal Player로 네이티브 앱 구축
Android, iOS, Apple TV 또는 Samsung Tizen을 선택하세요. 구독에 포함된 SDKs를 다운로드하고 공개 평가 플레이어를 사용해 보세요. 설정 단계와 앱 스크린샷도 확인할 수 있습니다.
SDK ZIP의 DEMO-QUICKSTART.md에 따라 PHP 데모를 사용해 보세요. 자체 콘텐츠를 사용하려면 먼저 웹사이트와 백엔드를 통합한 다음, MOBILE-AND-TV-APPS.md에 따라 앱을 동일한 로그인 및 시청 권한 규칙에 연결하세요.
1. 플랫폼을 선택하세요#
Android
Kotlin, Media3 및 Widevine. 전화 및 TV 샘플, 스트리밍 및 보호된 VOD 다운로드는 호환 장치에서 가능합니다.
APK를 사용해 보고 Android 앱을 만들어 보세요 →iPhone & iPad
Swift Package, SwiftUI, FairPlay. 터치 조작, 재생 목록, 보호된 다운로드를 제공합니다. iOS/iPadOS 15 이상.
iOS 앱 구축 →Apple TV
같은 Apple SDK에 리모컨 탐색, 재생 목록, FairPlay 스트리밍을 제공하는 tvOS 샘플 앱이 포함됩니다. tvOS 15 이상.
Apple TV 앱 구축 →Samsung Smart TV
JavaScript, Samsung AVPlay 및 Widevine DASH VOD. 전체 화면 제어, 재생 목록 및 원격 탐색.
TV 평가 키트를 사용해 보고 Tizen 앱을 구축해 보세요 →Amazon Fire TV (Vega OS)
React Native, native Vega media and Widevine VOD. Build a configurable app with playlist autoplay, fullscreen and text subtitles. SDK downloads require an active Professional or Enterprise subscription.
Build your Fire TV app →2. Console에서 SDK를 다운로드하세요.#
- 로그인하세요.활성 Professional 또는 Enterprise 구독을 보유한 고객 조직으로 Console → Developer Tools → Device SDKs를 여세요.
- 플랫폼 카드를 선택하세요.Android AAR 또는 전체 SDK, Apple SDK ZIP, Tizen SDK ZIP 중 필요한 파일을 다운로드합니다. iOS와 tvOS는 같은 Apple ZIP을 사용합니다.
- 추출 후 열기 README.md.제공된 폴더 구조를 유지합니다. Console에는 릴리스 세부 정보와 SHA-256 체크섬이 표시됩니다. 고객 SDK 번들을 비공개 팀 종속 저장소에 보관하세요.
- 샘플을 실행한 후 앱을 연결하세요.플랫폼 가이드를 따르세요. 자신의 앱 식별자와 서명 인증서를 사용하세요. 앱을 배포하기 전에 콘텐츠, 백엔드, 물리적 장치를 테스트하세요.
| 다운로드 | 접속 | 당신이 받는 것 |
|---|---|---|
| Android SDK | Professional / Enterprise | 1.0.0-preview.14: AAR, 전체 SDK, 빌드를 검증한 통합 샘플 프로젝트 |
| Apple SDK | Professional / Enterprise | 1.0.0-preview.4: Swift Package, iOS/tvOS Xcode 샘플 및 테스트 |
| Tizen SDK | Professional / Enterprise | 1.0.0-preview.3: JavaScript API, 타입 선언, 리모컨 샘플 및 테스트 |
| Android 평가 APK | 공개 | 서명된 데모 앱 다운로드 및 설치 |
| Samsung 평가 키트 / WGT | 공개 | 서명되지 않은 위젯과 로컬 보조 서비스. TV용으로 설정하고 서명하기 |
| Apple 앱 평가 | 적격 SDK에서 빌드 | Apple 팀과 함께 샘플에 서명하세요. 공개 IPA 또는 TestFlight 다운로드가 없습니다. |
Developer Tools → Device SDKs에서 다운로드하세요. SDK 사용에는 승인된 Professional 평가 계정을 포함하여 유효한 Professional 또는 Enterprise 권한이 필요합니다. Standard에서도 자체 플레이어용 네이티브 APIs를 사용할 수 있습니다. 세션 생성 및 라이선스 갱신 시 SDK 권한을 확인하며 오프라인 라이선스는 계정 서비스 기간을 초과할 수 없습니다.
3. 백엔드와 게시된 콘텐츠 연결#
- 암호화된 동영상을 패키징하고 게시합니다. Android/Tizen에는 DASH/CENC를 사용하고 Apple용 활성 FairPlay 배포에는 HLS/CBCS를 사용하세요.
- 자체 백엔드에 인증이 필요한 HTTPS 재생 세션 엔드포인트를 만드세요. 시청 권한을 확인하고 DRM-X Playback Session API를 호출합니다.
- 등록된 매니페스트, 라이선스/인증서 엔드포인트, 유효 시간이 짧은 인증 정보, 세션 해제 엔드포인트가 포함된 Universal Playback Session Contract v1을 반환하세요. Site Key와 Access Key는 서버에만 보관합니다.
- 앱의 엔드포인트, 게시된 Content IDs 및 뷰어 로그인 콜백을 설정합니다. 시청이 시작되면 스트리밍 세션이 생성됩니다. 재생을 중지하거나 교체하여 해제하세요.
- Play VOD 먼저. 콘텐츠에서 제공하는 오디오, 탐색, 캡션, 콘텐츠 전환, 액세스 거부 및 세션 해제를 확인하세요. 활성 이벤트 중에만 라이브로 테스트하세요.
SDK는 고객 로그인 또는 구독 논리를 대체하지 않습니다. 백엔드 예시부터 시작하세요. 아키텍처에 필요할 때 토큰 프록시를 사용하세요.
플레이어 인터페이스 보기#







샘플이 재생되지 않는 경우#
- SDK 다운로드 불가: 선택한 조직에 활성 Professional 또는 Enterprise 구독이 있는지 확인하세요. 세션이 만료된 경우 다시 로그인하세요.
- 영상 인증 실패: Published Content ID, 시청자 자격 및 서버 엔드포인트를 확인하세요. 이 문제를 해결하기 위해 테넌트 자격 증명을 앱에 넣지 마십시오.
- Apple 시뮬레이터에서는 FairPlay를 재생할 수 없습니다. 서명된 앱을 지원되는 실제 기기에서 실행하세요.
- Samsung 설치 실패: Developer Mode, DUID, 인증서 프로필 및 Permit to install applications를 확인하세요. Tizen 서명 단계를 따르세요.
- TV 영상이 끊기면 TV가 지원하는 코덱과 해상도를 사용하고 Full HD 디스플레이용 Full HD 영상을 제공하세요.
지원을 받으려면 SDK 버전, 기기/OS, Content ID, 시간 및 민감한 정보를 제거한 오류 코드를 공유하세요. 자격 증명, 세션 승인, 서명된 URL 및 라이선스 페이로드를 제외합니다.
DRM-X 6.0