SDK集成
更新时间：2025-12-08
本文为您介绍如何将 HarmonyOS NEXT 播放器 SDK 集成至您的项目中。
SDK&Demo下载
获取SDK&Demo
下载最新的播放器 HarmonyOS NEXT 播放器Demo及SDK，解压后文件目录如下：
说明：
- baiduPlayerSDK.har为HarmonyOS NEXT 播放器 SDK，Demo已集成sdk。
- baidudownloader.har为HarmonyOS NEXT 本地缓存下载 SDK，包括hls、mp4、flv等常见的音视频下载格式，Demo已集成sdk，可参考entry/src/ets/pages/CachePage.ets，不使用此功能可不引入此SDK。
- baiduRtcPlayer.har为HarmonyOS NEXT 超低延迟webrtc直播播放sdk，独立的播放组件，Demo已集成sdk，可参考entry/src/ets/controller/LowLatencyLivePlayer.ets，不使用此功能可不引入此SDK。
- entry为Demo示例代码，编译本Demo时，需要基于自己的华为账号更新项目的签名后，方可运行。
- 该Demo仅供集成SDK时参考，我们计划在后续发布版本中提供更多的演示内容。如果在集成过程中遇到任何问题，请随时与我们联系。
集成准备
环境要求
| 类别 | 说明 |
|---|---|
| 开发工具 | DevEco Studio（推荐使用最新版本） |
| 系统版本 | 鸿蒙HarmonyOS Next Next.0.0.26及其之后的稳定版本 |
| 兼容的最低 SDK 版本 | "compatibleSdkVersion": "5.0.0(12)" |
| 手机设备 | 推荐Huawei Mate 60系列手机，例如Huawei Mate 60 Pro（ALN-AL80） |
SDK集成
HarmonyOS NEXT 点播 SDK 可以通过har包本地配置的方式集成，也支持ohpm install方式引入。
添加依赖
ohpm install
1、安装
Plain Text
1ohpm install @baiduplayer/baiduplayersdk2、快速引入
Plain Text
1 import { BDCloudMediaPlayer, OnPreparedListener,InterruptEvent, InterruptHintType } from '@baiduplayer/baiduplayersdk'本地集成
1、将 har 文件放置于下图所示的路径中。
2、在 entry 下的 oh-package.json5 中添加依赖：
Plain Text
1 {
2 "name": "entry",
3 "version": "1.0.0",
4 "description": "Please describe the basic information.",
5 "main": "",
6 "author": "",
7 "license": "",
8 "dependencies": {
9 "baiduplayersdk":"file:../libs/baiduPlayerSDK.har",
10 "baidurtcplayer": "file:../libs/baiduRtcPlayer.har", // 超低延时直播独立SDK，高级版SDK特有，不使用此功能可不引入
11 "baidudownloader":"file:../libs/baidudownloader.har", // 下载独立sdk，可单独引入，不使用此功能可不引入
12 }
13 }3、声明权限 在 enrty 下的 module.json5 文件中声明权限：
Plain Text
1 "requestPermissions": [
2 {
3 // 网络权限，建议添加
4 "name": "ohos.permission.INTERNET"
5 },
6 {
7 // 获取 WIFI 信息，如获取 mac，建议添加
8 "name": "ohos.permission.GET_WIFI_INFO"
9 },
10 {
11 // 获取网络信息，建议添加
12 "name": "ohos.permission.GET_NETWORK_INFO"
13 },
14 {
15 // 资产持久化，建议添加
16 "name": "ohos.permission.STORE_PERSISTENT_DATA"
17 },
18 { // 获取WRITE_MEDIA权限，截图功能使用
19 "name": "ohos.permission.WRITE_MEDIA",
20 "reason": "$string:app_name",
21 "usedScene": {
22 "abilities": [
23 "FormAbility"
24 ],
25 "when":"always"
26 }
27 },
28 { // 获取READ_MEDIA权限，截图功能使用
29 "name": "ohos.permission.READ_MEDIA",
30 "reason": "$string:app_name",
31 "usedScene": {
32 "abilities": [
33 "FormAbility"
34 ],
35 "when":"always"
36 }
37 }
38]配置证书
- 申请播放器SDK license：
您需要登录百度智能云控制台申请获取播放器SDK license。
-
配置证书
下载申请的证书，复制到 entry/src/main/resources/rawfile目录下。
- 证书鉴权
将.license文件放到自己工程assets目录下后，在使用播放器前需将licenseId设置给播放器。调用BDCloudMediaPlayer的静态方法setAppId来设置appid(licenseId)
Plain Text
1 await BDCloudMediaPlayer.setAppId(licenseId);