DRM-X 6.0 鸽子和橄榄枝标志DRM-X 6.0文档
◎ 简体中文

使用 Universal Player 构建原生应用

选择 Android、iOS、Apple TV 或 Samsung Tizen。下载您的订阅可用的 SDKs,试用公开评估播放器,按照指南完成设置,并查看应用截图。

查看 Markdown在线示例更新于 2026-09-21

按照 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 提供 tvOS 示例应用,支持遥控器导航、播放列表和 FairPlay 在线播放,最低要求为 tvOS 15。

构建您的 Apple TV 应用程序 →

Samsung Smart TV

JavaScript、Samsung AVPlay 和 Widevine DASH VOD。支持全屏控件、播放列表和遥控器导航。

试用 TV 评估套件并构建 Tizen 应用 →

Amazon Fire TV (Vega OS)

使用 React Native、Vega 原生视频组件和 Widevine VOD 点播,构建可配置的应用,支持播放列表自动播放、全屏和文本字幕。下载 SDK 需要有效的 Professional 或 Enterprise 订阅。

构建您的 Fire TV 应用 →

2. 从 Console 下载 SDK#

  1. 登录。使用具有有效 Professional 或 Enterprise 订阅的客户组织,打开 Console → Developer Tools → Device SDKs。
  2. 选择平台卡片。下载 Android AAR/完整 SDK、Apple SDK ZIP 或 Tizen SDK ZIP。iOS 和 tvOS 共用同一 Apple ZIP。
  3. 解压并打开 README.md。保留原有目录结构。Console 提供版本说明与 SHA-256 校验值。将客户 SDK 软件包存放在团队私有的依赖存储中。
  4. 运行示例,然后连接您的应用程序。遵循平台指南。使用您自己的应用程序标识符和签名证书。在分发应用程序之前测试您的内容、后端和真实设备。
下载访问权限提供的内容
Android SDKProfessional / Enterprise1.0.0-preview.14 AAR、完整 SDK,以及已通过编译验证的 SDK 接入示例项目
Apple SDKProfessional / Enterprise1.0.0-preview.4 Swift Package、iOS/tvOS Xcode 示例和测试
Tizen SDKProfessional / Enterprise1.0.0-preview.3 JavaScript API、类型声明、遥控器示例和测试
Android 评估 APK公开已签名的演示应用程序; 下载并安装
Samsung 评估套件 / WGT公开未签名的 Widget 和本地配套服务;针对您的 TV 配置并签名
Apple 评估方式使用符合订阅条件的 SDK 自行构建使用自己的 Apple 开发团队为示例签名。目前不提供公开的 IPA 或 TestFlight 下载。

在 Developer Tools → Device SDKs 下载。使用 SDK 需要有效的 Professional 或 Enterprise 权限,包括已获批准的 Professional 评估账户。Standard 仍可通过原生 APIs 构建自己的播放器。创建会话和续订许可证时会检查 SDK 权限;离线许可证的有效期不会超过账户服务期。

3. 连接您的后端和已发布的内容#

  1. 打包加密并发布一个视频。Android/Tizen 使用 DASH/CENC;Apple 使用 HLS/CBCS,并需要有效的 FairPlay 部署。
  2. 在您自己的后端中创建经过身份验证的 HTTPS 播放会话端点。它检查观看者的权限并调用DRM-X 播放会话 API。
  3. 返回 Universal Playback Session Contract v1,包含已注册的 manifest、许可证和证书接口、短期授权及会话释放接口。Site Key 和 Access Key 必须留在服务器端。
  4. 设置应用的端点、发布的 Content IDs 和观众登录回调。观看开始时创建流会话;停止或替换播放以将其释放。
  5. 先测试 VOD。检查音频、跳转、内容自带字幕、内容切换、拒绝访问和会话释放。仅在直播正在进行时测试直播。

SDK 不会取代您的客户登录或订阅逻辑。从后端示例开始;当您的架构需要时,使用 令牌代理。

查看播放器界面#

查看 Android 原始截图

播放效果合成示意图。播放器界面中加入了提供的视频画面和示例字幕。
播放效果合成示意图。播放器界面中加入了提供的视频画面和示例字幕。
播放效果合成示意图。播放器界面中加入了提供的视频画面和示例字幕。
播放效果合成示意图。播放器界面中加入了提供的视频画面和示例字幕。
Android TV
Android TV。概念示意图。
车载乘客显示屏
车载显示屏。概念示意图。
飞机座椅背部显示屏
飞机座椅背部显示屏。概念示意图。

示例无法播放时如何处理#

  • SDK 下载不可用:确认所选组织有活跃的 Professional 或 Enterprise 订阅;如果会话过期,请重新登录。
  • 视频授权失败:检查 PublishedContent ID、观众权限和服务器端点。不要将租户凭据放入应用程序中来解决此问题。
  • Apple 模拟器无法播放: 在已签名的真实设备上运行 FairPlay。
  • Samsung 安装失败:检查 Developer Mode、DUID、证书配置文件和 Permit to install applications。请遵循 Tizen 签名步骤。
  • 电视画面卡顿:使用电视支持的编解码器和分辨率,并为 Full HD 显示屏提供 Full HD 视频版本。

联系支持时,请提供 SDK 版本、设备/OS、Content ID、发生时间和已脱敏的错误代码。不要提供凭据、会话授权、签名 URL 或许可证请求及响应载荷。