SDK集成
更新时间：2026-06-02
本文为您介绍如何将 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。
- ProjectionWrapper.har为HarmonyOS NEXT 投屏sdk，高级版SDK特有，独立的投屏组件，Demo已集成sdk，可参考entry/src/ets/pages/RemoteControlPage.ets,不使用此功能可不引入此SDK。
- baiduRtcPlayer.har为HarmonyOS NEXT 超低延迟webrtc直播播放sdk，高级版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 "@baiduplayer/baiduplayersdk":"file:../libs/baiduPlayerSDK.har",
10 "baidurtcplayer": "file:../libs/baiduRtcPlayer.har", // 超低延时直播独立SDK，高级版SDK特有，不使用此功能可不引入
11 "baidudownloader":"file:../libs/baidudownloader.har", // 下载独立sdk，可单独引入，不使用此功能可不引入
12 "@baiduplayer/projectionwrapper":"file:../libs/ProjectionWrapper.har", // 投屏SDK，高级版SDK特有，不使用此功能可不引入
13 }
14 }3、声明权限 在 enrty 下的 module.json5 文件中声明权限：
Plain Text
1 "requestPermissions": [
2 {
3 // 网络权限，建议添加
4 "name": "ohos.permission.INTERNET"
5 },
6 { // 获取WRITE_MEDIA权限，截图功能使用
7 "name": "ohos.permission.WRITE_MEDIA",
8 "reason": "$string:app_name",
9 "usedScene": {
10 "abilities": [
11 "FormAbility"
12 ],
13 "when":"always"
14 }
15 },
16 { // 获取READ_MEDIA权限，截图功能使用
17 "name": "ohos.permission.READ_MEDIA",
18 "reason": "$string:app_name",
19 "usedScene": {
20 "abilities": [
21 "FormAbility"
22 ],
23 "when":"always"
24 }
25 },
26 { // 获取网络信息，投屏功能使用
27 "name": "ohos.permission.GET_NETWORK_INFO",
28 "reason": "$string:app_name",
29 "usedScene": {
30 "abilities": [
31 "EntryAbility",
32 "FormAbility"
33 ],
34 "when": "inuse"
35 }
36 },
37 {
38 "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
39 "reason": "$string:app_name",
40 "usedScene": {
41 "abilities": [
42 "EntryAbility",
43 "FormAbility"
44 ],
45 "when": "inuse"
46 }
47 }
48]配置证书
- 申请播放器SDK license：
您需要登录百度智能云控制台申请获取播放器SDK license。
-
配置证书
下载申请的证书，复制到 entry/src/main/resources/rawfile目录下。
- 证书鉴权
将.license文件放到自己工程assets目录下后，在使用播放器前需将licenseId设置给播放器。调用BDCloudMediaPlayer的静态方法setAppId来设置appid(licenseId)
Plain Text
1 await BDCloudMediaPlayer.setAppId(licenseId);评价此篇文章