导航
集成 SDK
最近更新时间：2025.03.26 11:04:54首次发布时间：2025.03.25 21:39:20
uni-app 播放器 SDK 是基于 Android 和 iOS 原生播放器 SDK 的统一封装解决方案，旨在为开发者提供跨平台的播放器集成能力。
开发环境
集成 SDK 前，请参考以下步骤搭建 App 开发环境：
- 下载 HBuilderX 编辑器。
说明
推荐使用最新版本。如果您此前已下载过 HBuilderX，为保证开发环境统一请更新到最新版本。
- 在 DCloud 开发者中心注册后登录 HBuilderX 编辑器。
获取 License
视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段，您可以在视频点播控制台申请免费的测试 License。您需完成以下操作：
注意
测试 License 仅限项目测试阶段使用，不可续期。测试 License 到期会导致鉴权失败，进而影响业务的正常使用。项目上线前，请升级至正式 License。
集成步骤
步骤 1：集成 uni-app 原生插件
- 将以下
uniplugin-vod-player原生插件下载至本地：
- 将文件解压至 uni-app 项目的
nativeplugins目录下。 - 通过 HBuilder 打开 uni-app 项目。
- 在项目根目录下
manifest.json文件的 App 原生插件配置项下单击选择本地插件，然后在列表中选择需要打包生效的插件，如下图所示：
说明
- 更多信息，请见 uni-app 原生插件使用教程。
- 请使用自定义基座打包项目测试播放器，自定义基座不是正式版，真正发布时需要再打正式包。使用自定义基座无法正常升级替换 APK。
步骤 2：集成 uni-app JS 封装层 SDK
- 将以下
uni-vod-playerJS 封装层 SDK 下载至本地：
- 将文件解压至 uni-app 项目根目录下。
步骤 3：添加 License 文件
从视频点播控制台下载 License 文件后，将其作为原生资源文件， 放入 uni-app 项目的 nativeResources 文件夹下（如果没有该文件夹则自行创建），如下图所示。后续在初始化 SDK 时您需要传入 License 文件路径。
后续操作
至此，您已完成 uni-app 播放器 SDK 的集成。后续可使用 uni-app 播放器 SDK 播放视频，详情请见基础功能。