# Universal Player로 네이티브 앱 구축 Android, iOS, Apple TV 또는 Samsung Tizen를 선택합니다. 적격한 SDKs를 다운로드하고, 공개 평가 플레이어를 사용해 보고, 설정 단계를 따르고, 앱 스크린샷을 확인하세요. ** DRM-X Universal Player.**로 앱을 빌드하세요. Android, iOS/iPadOS, Apple TV 또는 Samsung Tizen를 선택하세요. 각 패키지에는 플레이어 통합, 샘플 앱 및 설정 지침이 포함되어 있습니다. SDKs는 개발자 미리보기입니다. 아래 테스트 결과를 검토하고 출시 전에 자신의 앱을 테스트해 보세요. ## 1. 플랫폼을 선택하세요[#](#choose-your-platform) ### Android Kotlin, Media3 및 Widevine. 전화 및 TV 샘플, 스트리밍 및 보호된 VOD 다운로드는 호환 장치에서 가능합니다. [APK를 사용해 보고 Android 앱을 만들어 보세요 →](https://docs.drm-x.com/ko/sdk/android) ### iPhone & iPad Swift Package, SwiftUI, FairPlay. 터치 조작, 재생 목록, 보호된 다운로드를 제공합니다. iOS/iPadOS 15 이상. [iOS 앱 구축 →](https://docs.drm-x.com/ko/sdk/apple#ios-quick-start) ### Apple TV 같은 Apple SDK에 리모컨 탐색, 재생 목록, FairPlay 스트리밍을 제공하는 tvOS 샘플 앱이 포함됩니다. tvOS 15 이상. [Apple TV 앱 구축 →](https://docs.drm-x.com/ko/sdk/apple#tvos-quick-start) ### Samsung Smart TV JavaScript, Samsung AVPlay 및 Widevine DASH VOD. 전체 화면 제어, 재생 목록 및 원격 탐색. [TV 평가 키트를 사용해 보고 Tizen 앱을 구축해 보세요 →](https://docs.drm-x.com/ko/sdk/tizen) ## 2. Console에서 SDK를 다운로드하세요.[#](#download-sdk) - **로그인하세요.**활성 **Professional** 또는 **Enterprise** 구독을 보유한 고객 조직으로 [Console → Integrations](https://6.drm-x.com/console/integrations)를 여세요. - **플랫폼 카드를 선택하세요.**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.13: AAR, 전체 SDK, 빌드를 검증한 통합 샘플 프로젝트 | | Apple SDK | Professional / Enterprise | 1.0.0-preview.3: Swift Package, iOS/tvOS Xcode 샘플 및 테스트 | | Tizen SDK | Professional / Enterprise | 1.0.0-preview.1: JavaScript API, 타입 선언, 리모컨 샘플 및 테스트 | | Android 평가 APK | 공개 | 서명된 데모 앱 [다운로드 및 설치](https://docs.drm-x.com/ko/sdk/android#try-android-app) | | Samsung 평가 키트 / WGT | 공개 | 서명되지 않은 위젯과 로컬 보조 서비스. [TV용으로 설정하고 서명하기](https://docs.drm-x.com/ko/sdk/tizen#try-tv-app) | | Apple 앱 평가 | 적격 SDK에서 빌드 | Apple 팀과 함께 샘플에 서명하세요. 공개 IPA 또는 TestFlight 다운로드가 없습니다. | Trial 및 Standard 계정은 모든 가이드를 읽고 공개 평가 앱을 다운로드할 수 있습니다. SDK 이전 다운로드 링크를 재사용하는 경우를 포함하여 다운로드 권한은 서버에서 확인됩니다. ## 3. 백엔드와 게시된 콘텐츠 연결[#](#connect-your-backend) - [암호화된 동영상을 패키징하고 게시](https://docs.drm-x.com/ko/packaging/overview)합니다. Android/Tizen에는 DASH/CENC를 사용하고 Apple용 활성 FairPlay 배포에는 HLS/CBCS를 사용하세요. - 자체 백엔드에 인증이 필요한 HTTPS 재생 세션 엔드포인트를 만드세요. 시청 권한을 확인하고 [DRM-X Playback Session API](https://docs.drm-x.com/ko/api-reference/playback-sessions)를 호출합니다. - 등록된 매니페스트, 라이선스/인증서 엔드포인트, 유효 시간이 짧은 인증 정보, 세션 해제 엔드포인트가 포함된 Universal Playback Session Contract v1을 반환하세요. Site Key와 Access Key는 서버에만 보관합니다. - 앱의 엔드포인트, 게시된 Content IDs 및 뷰어 로그인 콜백을 설정합니다. 시청이 시작되면 스트리밍 세션이 생성됩니다. 재생을 중지하거나 교체하여 해제하세요. - Play VOD 먼저. 콘텐츠에서 제공하는 오디오, 탐색, 캡션, 콘텐츠 전환, 액세스 거부 및 세션 해제를 확인하세요. 활성 이벤트 중에만 라이브로 테스트하세요. SDK는 고객 로그인 또는 구독 논리를 대체하지 않습니다. [백엔드 예시](https://docs.drm-x.com/ko/integrations/backend-languages)부터 시작하세요. 아키텍처에 필요할 때 [토큰 프록시](https://docs.drm-x.com/ko/license-service/token-proxy)를 사용하세요. ## 플레이어 인터페이스 보기[#](#app-screenshots) 스마트폰, TV, 승객용 디스플레이의 재생 경험을 살펴보세요. 편집된 플레이어 이미지에는 제공된 동영상 장면과 예시 자막이 포함됩니다. 실제 기기 테스트 결과는 아래에 별도로 안내합니다. [![재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다.](https://docs.drm-x.com/assets/native-apps/android-playback-illustration.png?v=20260918-clean)](https://docs.drm-x.com/assets/native-apps/android-playback-illustration.png?v=20260918-clean)재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다. [![재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다.](https://docs.drm-x.com/assets/native-apps/iphone-playback-illustration.png?v=20260918-clean)](https://docs.drm-x.com/assets/native-apps/iphone-playback-illustration.png?v=20260918-clean)재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다. [Android 원본 스크린샷 보기](https://docs.drm-x.com/assets/native-apps/android-settings-capture-20260918.png) [![재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다.](https://docs.drm-x.com/assets/native-apps/apple-tv-playback-illustration.png?v=20260918-clean)](https://docs.drm-x.com/assets/native-apps/apple-tv-playback-illustration.png?v=20260918-clean)재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다. [![재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다.](https://docs.drm-x.com/assets/native-apps/samsung-tv-playback-illustration.png?v=20260918-clean)](https://docs.drm-x.com/assets/native-apps/samsung-tv-playback-illustration.png?v=20260918-clean)재생 모습을 보여 주는 합성 이미지입니다. 플레이어 화면에 제공된 동영상 장면과 예시 자막을 추가했습니다. ![Android TV](https://docs.drm-x.com/assets/native-apps/android-tv-playback-illustration.png?v=20260918-clean)Android TV. 콘셉트 이미지입니다. 기기와 재생 장면은 생성된 이미지이며, 각 배포 환경에서 호환성을 검증해야 합니다. ![차량 승객용 디스플레이](https://docs.drm-x.com/assets/native-apps/automotive-playback-illustration.png?v=20260918-clean)차량 승객용 디스플레이. 콘셉트 이미지입니다. 기기와 재생 장면은 생성된 이미지이며, 각 배포 환경에서 호환성을 검증해야 합니다. ![항공기 좌석 등받이 디스플레이](https://docs.drm-x.com/assets/native-apps/aircraft-playback-illustration.png?v=20260918-clean)항공기 좌석 등받이 디스플레이. 콘셉트 이미지입니다. 기기와 재생 장면은 생성된 이미지이며, 각 배포 환경에서 호환성을 검증해야 합니다. ## 출시 전 테스트된 장치 및 점검 사항[#](#tested-devices) | 플랫폼 | 디바이스 테스트 완료 | 앱에서 테스트할 내용 | | --- | --- | --- | | Android | Samsung Android 기기: VOD/오프라인 흐름 및 라이브 키 순환; 9월 17일 라이브 실행이 1920×1080에 도달했습니다. | 장치/CDM, 품질/출력 정책, 오프라인 만료, 콜드 스타트 ​​및 갱신. 이 결과는 Android 4K 재생을 주장하지 않습니다. | | iOS | iPhone: VOD, 보호된 다운로드/재개/갱신; 6분간의 4K 지원 라이브/키 순환 실행. | 완전히 연결이 끊긴 콜드 스타트, 콘텐츠/출력 정책 및 물리적 iPad. 시뮬레이터 레이아웃은 FairPlay 재생 증거가 아닙니다. | | tvOS | 물리적 Apple TV: FairPlay VOD 및 원격 제어. | 라이브, 4K/HDR 및 각 Apple TV/출력 조합. 이 패키지는 tvOS 스트리밍을 제공합니다. | | Samsung Tizen | Samsung Smart TV (Tizen): 보호된 Full HD VOD, 지속적인 재생, 영어/중국어 자막 전환을 9월 17일에 확인했습니다. | 새로운 백엔드 통합을 자체 백엔드 및 각 TV에서 검증하세요. 라이브, 오프라인, HDR은 아직 검증하지 않았습니다. 평가 앱을 사용하는 동안 로컬 보조 서비스가 계속 실행되어야 합니다. | 고객용 SDK 검증: Android 통합 샘플은 제공된 AAR로 컴파일했습니다. Apple 패키지는 25개 테스트와 Xcode 26.3에서 iOS/tvOS 두 샘플의 시뮬레이터 빌드를 통과했습니다. Tizen의 라이프사이클, UI, 로컬 보조 서비스 테스트도 통과했습니다. 실제 기기 결과는 앞서 테스트한 엔진과 UI에 해당하며, 모든 고객용 패키지를 새로 실기 검증한 결과는 아닙니다. ## 샘플이 재생되지 않는 경우[#](#get-help) - **SDK 다운로드 불가:** 선택한 조직에 활성 Professional 또는 Enterprise 구독이 있는지 확인하세요. 세션이 만료된 경우 다시 로그인하세요. - **영상 인증 실패:** Published Content ID, 시청자 자격 및 서버 엔드포인트를 확인하세요. 이 문제를 해결하기 위해 테넌트 자격 증명을 앱에 넣지 마십시오. - **Apple 시뮬레이터에서는 FairPlay를 재생할 수 없습니다.** 서명된 앱을 지원되는 실제 기기에서 실행하세요. - **Samsung 설치 실패:** Developer Mode, DUID, 인증서 프로필 및 Permit to install applications를 확인하세요. Tizen 서명 단계를 따르세요. - **TV 비디오 끊김:** 호환 가능한 코덱/rendition 래더 제공; 테스트된 M5에는 UHD 첫 번째 데모 매니페스트가 아닌 Full HD가 필요합니다. 지원을 받으려면 SDK 버전, 기기/OS, Content ID, 시간 및 민감한 정보를 제거한 오류 코드를 공유하세요. 자격 증명, 세션 승인, 서명된 URL 및 라이선스 페이로드를 제외합니다.