You need to enable JavaScript to run this app.
导航
集成 SDK
最近更新时间:2025.06.06 16:12:33首次发布时间:2024.08.16 14:11:59
我的收藏
有用
有用
无用
无用

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

开发环境

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

获取 License

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

注意

测试 License 仅限项目测试阶段使用,不可续期。测试 License 到期会导致鉴权失败,进而影响业务的正常使用。项目上线前,请升级至正式 License

集成 SDK

步骤 1:添加仓库

在项目根目录下创建 .ohpmrc 文件并配置 OpenHarmony 三方库中心仓和火山引擎仓库地址。

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

示意图如下:

步骤 2:添加 SDK 依赖

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

说明

请参见发布历史获取 SDK 最新版本号。

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

示意图如下:

步骤 3:声明权限

enrty 下的 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 的基础功能和进阶功能: