# 使用 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/zh-Hans/sdk/android) ### iPhone & iPad Swift Package、SwiftUI 和 FairPlay。支持触控、播放列表和受保护下载。最低要求为 iOS/iPadOS 15。 [构建您的 iOS 应用程序 →](https://docs.drm-x.com/zh-Hans/sdk/apple#ios-quick-start) ### Apple TV 同一 Apple SDK 提供 tvOS 示例应用，支持遥控器导航、播放列表和 FairPlay 在线播放，最低要求为 tvOS 15。 [构建您的 Apple TV 应用程序 →](https://docs.drm-x.com/zh-Hans/sdk/apple#tvos-quick-start) ### Samsung Smart TV JavaScript、Samsung AVPlay 和 Widevine DASH VOD。支持全屏控件、播放列表和遥控器导航。 [试用 TV 评估套件并构建 Tizen 应用 →](https://docs.drm-x.com/zh-Hans/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，以及已通过编译验证的 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/zh-Hans/sdk/android#try-android-app) | | Samsung 评估套件 / WGT | 公开 | 未签名的 Widget 和本地配套服务；[针对您的 TV 配置并签名](https://docs.drm-x.com/zh-Hans/sdk/tizen#try-tv-app) | | Apple 评估方式 | 使用符合订阅条件的 SDK 自行构建 | 使用自己的 Apple 开发团队为示例签名。目前不提供公开的 IPA 或 TestFlight 下载。 | Trial 和 Standard 帐户可以阅读每篇指南并下载公共评估应用程序。 SDK 服务器会检查下载权限，包括重复使用旧下载链接时。 ## 3. 连接您的后端和已发布的内容[#](#connect-your-backend) - [打包加密并发布](https://docs.drm-x.com/zh-Hans/packaging/overview)一个视频。Android/Tizen 使用 DASH/CENC；Apple 使用 HLS/CBCS，并需要有效的 FairPlay 部署。 - 在您自己的后端中创建经过身份验证的 HTTPS 播放会话端点。它检查观看者的权限并调用[DRM-X 播放会话 API](https://docs.drm-x.com/zh-Hans/api-reference/playback-sessions)。 - 返回 Universal Playback Session Contract v1，包含已注册的 manifest、许可证和证书接口、短期授权及会话释放接口。Site Key 和 Access Key 必须留在服务器端。 - 设置应用的端点、发布的 Content IDs 和观众登录回调。观看开始时创建流会话；停止或替换播放以将其释放。 - 先测试 VOD。检查音频、跳转、内容自带字幕、内容切换、拒绝访问和会话释放。仅在直播正在进行时测试直播。 SDK 不会取代您的客户登录或订阅逻辑。从[后端示例](https://docs.drm-x.com/zh-Hans/integrations/backend-languages)开始；当您的架构需要时，使用 [令牌代理](https://docs.drm-x.com/zh-Hans/license-service/token-proxy)。 ## 查看播放器界面[#](#app-screenshots) 图片展示应用控件，不包含账号资料、凭据或许可证 Token。DRM 保护的视频在截图中可能呈黑色；仅凭截图无法证明播放能力。 [![Android 播放器设置屏幕截图，包含质量、音频、字幕和速度控制](https://docs.drm-x.com/assets/android-player-settings-preview4.png)](https://docs.drm-x.com/assets/android-player-settings-preview4.png)**Android 设置。**早期开发 UI 捕获。当前的 APK 添加了 Android 指南中描述的更新。点击视频内的设置控件以选择支持的曲目和播放选项。 [![iPhone 真机 Universal Player 处于 Ready 状态，显示已下载播放列表](https://docs.drm-x.com/assets/native-apps/iphone-player.png)](https://docs.drm-x.com/assets/native-apps/iphone-player.png)**iPhone 真机应用。**展示 Ready 状态和已下载播放列表。选择视频后按 Play，使用视频内的设置选择字幕和音轨。图片展示应用界面，并非正在播放的电影画面。 [![Apple TV 真机播放器处于暂停状态，展示播放列表和播放控件](https://docs.drm-x.com/assets/native-apps/apple-tv-player.png)](https://docs.drm-x.com/assets/native-apps/apple-tv-player.png)**Apple TV 真机应用。**左侧为播放列表，视频下方为播放和设置控件。受保护视频区域在截图中呈黑色。使用遥控器选择视频、移动焦点、跳转或进入全屏。 [![SamsungTV 界面桌面预览明确标注无视频播放](https://docs.drm-x.com/assets/native-apps/tizen-ui-preview.png)](https://docs.drm-x.com/assets/native-apps/tizen-ui-preview.png)**Samsung 界面预览。**截取自桌面测试环境中的现有 UI，并明确标记“NO VIDEO PLAYBACK”。它展示播放列表、遥控器焦点和控件位置。M5 真机 VOD 测试结果另列于下方。 ## 已测试设备与发布前检查[#](#tested-devices) | 平台 | 已完成设备测试 | 在您的应用中测试什么 | | --- | --- | --- | | Android | Samsung S24 Ultra：VOD/离线流程和直播密钥轮换； 9 月 17 日直播达到 1920×1080。 | 验证自己的设备/CDM、画质和输出策略、离线到期、冷启动及续订。本次结果未验证 Android 4K 播放。 | | iOS | iPhone 11：VOD、受保护下载/恢复/续订；支持 4K 的六分钟直播及密钥轮换测试。 | 完全断网后的冷启动、您的内容和输出策略，以及 iPad 真机。模拟器界面测试不能证明 FairPlay 播放正常。 | | tvOS | 物理 Apple TV：FairPlay VOD 和遥控器。 | 直播、4K/HDR，以及各 Apple TV 与输出设备组合。本 SDK 在 tvOS 上提供在线播放。 | | Samsung Tizen | M5 LS27DM501EEXXY / Tizen 9：2026 年 9 月 17 日确认了受保护 Full HD VOD 的持续播放，以及英文/中文字幕切换。 | 使用自己的后端和每个目标 TV 验证新增的客户后端集成。直播、离线和 HDR 尚未验证。评估应用需要本地配套服务持续运行。 | 客户版本验证：Android 接入示例已使用交付的 AAR 编译通过；Apple SDK 通过了 25 项测试，并在 Xcode 26.3 上通过 iOS/tvOS 示例的模拟器构建；Tizen 生命周期、UI 和配套服务测试通过。设备测试结果来自此前实际测试的引擎和 UI，不代表每个客户 SDK 软件包均已重新完成真机验收。 ## 示例无法播放时如何处理[#](#get-help) - **SDK 下载不可用：**确认所选组织有活跃的 Professional 或 Enterprise 订阅；如果会话过期，请重新登录。 - **视频授权失败：**检查 PublishedContent ID、观众权限和服务器端点。不要将租户凭据放入应用程序中来解决此问题。 - **Apple 模拟器无法播放：** 在已签名的真实设备上运行 FairPlay。 - **Samsung 安装失败：**检查 Developer Mode、DUID、证书配置文件和 Permit to install applications。请遵循 Tizen 签名步骤。 - **TV 视频卡顿：**提供兼容的编解码器与编码档位。已测试的 M5 需要 Full HD，而不是优先使用 UHD 的演示 manifest。 联系支持时，请提供 SDK 版本、设备/OS、Content ID、发生时间和已脱敏的错误代码。不要提供凭据、会话授权、签名 URL 或许可证请求及响应载荷。