本文为您介绍如何将 HarmonyOS NEXT 播放器 SDK 集成至您的项目。

Demo 源码

为降低您集成 HarmonyOS Next 播放器 SDK 时的学习与开发成本，我们建议您下载 Demo 源码，并依据工程目录下的 README 文件实现短视频场景。详见体验地址。

开发环境

• 开发环境：DevEco Studio（推荐使用最新版本）
• 兼容的最低 SDK 版本："compatibleSdkVersion": "5.0.1(13)"
• ABI 兼容性：架构要求 arm64

获取 License

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段，您可以在视频点播控制台申请免费的测试 License。您需完成创建应用、申请免费测试 License、绑定 License 与应用，详细操作步骤，请见应用管理和播放器 License。

集成 SDK

步骤 1：添加仓库

为确保 ohpm 构建工具能够找到并下载火山引擎播放器 SDK，您需要在项目根目录下创建 .ohpmrc 文件并配置 OpenHarmony 三方库中心仓和火山引擎仓库地址。

registry=https://ohpm.openharmony.cn/ohpm/,https://artifact.bytedance.com/repository/byted-ohpm/

示意图如下：

步骤 2：添加 SDK 依赖

在 entry 下的 oh-package.json5 中添加 SDK 依赖：

{
  "name": "entry",
  "version": "1.0.0",
  "description": "Please describe the basic information.",
  "main": "",
  "author": "",
  "license": "",
  "dependencies": {
     // 将 xxx 替换成最新版本号
    "@simplayer/simkit_api": "xxx",
  }
}

示意图如下：

步骤 3：声明权限

在 entry/src 下的 module.json5 文件中声明权限：

"requestPermissions": [
  {
    // 网络权限，建议添加
    "name": "ohos.permission.INTERNET"
  },
  {
    // 获取 WIFI 信息，如获取 mac，建议添加
    "name": "ohos.permission.GET_WIFI_INFO"
  },
  { 
    // 获取网络信息，建议添加
    "name": "ohos.permission.GET_NETWORK_INFO"
  },
  {
    // 资产持久化，建议添加
    "name": "ohos.permission.STORE_PERSISTENT_DATA"
  },
],

后续操作

参考以下文档实现播放器 SDK 的基础功能和进阶功能：

• 基础功能
• 进阶功能