使用 Universal Player 构建原生应用
选择 Android、iOS、Apple TV 或 Samsung Tizen。下载您的订阅可用的 SDKs,试用公开评估播放器,按照指南完成设置,并查看应用截图。
按照 SDK ZIP 中的 DEMO-QUICKSTART.md 试用 PHP 演示。使用您自己的内容时,请先完成网站/后端集成,再按照 MOBILE-AND-TV-APPS.md 将应用连接到同一套登录系统和观看权限规则。
1. 选择您的平台#
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#
- 登录。使用具有有效 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,以及已通过编译验证的 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 | 公开 | 未签名的 Widget 和本地配套服务;针对您的 TV 配置并签名 |
| Apple 评估方式 | 使用符合订阅条件的 SDK 自行构建 | 使用自己的 Apple 开发团队为示例签名。目前不提供公开的 IPA 或 TestFlight 下载。 |
在 Developer Tools → Device SDKs 下载。使用 SDK 需要有效的 Professional 或 Enterprise 权限,包括已获批准的 Professional 评估账户。Standard 仍可通过原生 APIs 构建自己的播放器。创建会话和续订许可证时会检查 SDK 权限;离线许可证的有效期不会超过账户服务期。
3. 连接您的后端和已发布的内容#
- 打包加密并发布一个视频。Android/Tizen 使用 DASH/CENC;Apple 使用 HLS/CBCS,并需要有效的 FairPlay 部署。
- 在您自己的后端中创建经过身份验证的 HTTPS 播放会话端点。它检查观看者的权限并调用DRM-X 播放会话 API。
- 返回 Universal Playback Session Contract v1,包含已注册的 manifest、许可证和证书接口、短期授权及会话释放接口。Site Key 和 Access Key 必须留在服务器端。
- 设置应用的端点、发布的 Content IDs 和观众登录回调。观看开始时创建流会话;停止或替换播放以将其释放。
- 先测试 VOD。检查音频、跳转、内容自带字幕、内容切换、拒绝访问和会话释放。仅在直播正在进行时测试直播。
查看播放器界面#





示例无法播放时如何处理#
- 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 或许可证请求及响应载荷。
DRM-X 6.0
