• Home
Name Date Size #Lines LOC

..--

AppScope/12-May-2024-3633

ScreenShots/12-May-2024-

entry/12-May-2024-1,4041,092

.gitignoreD12-May-202456 55

Readme.mdD12-May-20242.7 KiB5042

build-profile.json5D12-May-20241 KiB4241

hvigorfile.jsD12-May-2024168 21

package.jsonD12-May-2024382 1818

Readme.md

1后台播放音乐
2===============================
3
4# 介绍
5本示例基于API9 stage应用开发模型,用于验证OpenHarmony提供的后台播放音乐时申请长时任务功能
6
71. 该示例简单使用了TAB组件、Page跳转进行布局和交互
82. 使用AudioPlayer组件进行音乐播放
93. 播放同时后台申请长时任务,停止播放时撤销长时任务,长时任务申请成功会在通知栏提示
104. 需在配置文件声明后台运行权限
11
12使用说明:
131. 安装应用后找到应用“PlayBG”, 点击图标打开应用
142. 进入默认首页是'My'tab页,页面上有系统默认自带的2首歌曲,点击歌曲名称,例如点击dynamic.wav
153. 上一步操作会进入音乐播放详情页面,点击播放按钮,音乐开始播放
164. 音乐开始播放,在通知栏消息可以看到PlayBG消息,表明已成功申请长时任务在后台运行
175. 点击‘暂停’图标按钮,音乐停止播放,通知栏消息消失
18
19# 效果预览
20![](ScreenShots/Screenshot_46388150763.jpg)
21![](ScreenShots/Screenshot_46388401314.jpg)
22![](ScreenShots/Screenshot_46388434782.jpg)
23
24# 相关权限
25示例应用申请权限, 详见示例工程module.json5文件
26entry/src/main/module.json5文件里申请:
271. 长时任务权限
28    module节点申请:
29    "requestPermissions": [
30        {
31    "name": "ohos.permission.KEEP_BACKGROUND_RUNNING"  // 长时任务权限
32        }
33    ]
34参考:https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/task-management/continuous-task-dev-guide.md#%E5%9F%BA%E4%BA%8Estage%E6%A8%A1%E5%9E%8B
352. 媒体播放权限
36   abilities节点申请:
37   "backgroundModes": ["audioPlayback"] // declare background mode
38
39# 依赖
401. 依赖avSession组件最新版本,2022/11/30正式发布sdk,在这之前可以使用sdk每日构建进行验证,每日构建地址如下:
41   http://ci.openharmony.cn/dailys/dailybuilds
42   替换avSession库,例如这里把下载好的xxx-ohos-sdk.tar.gz => ets => api => @ohos.multimedia.avsession.d.ts拷贝到你的工程sdk目录,例如我的目录是这个:
43   C:\Users\xxx\AppData\Local\OpenHarmony\Sdk\ets\3.2.7.5\api
44
45# 约束与限制
46本示例仅支持标准系统上运行,支持设备:RK3568;
47本示例仅支持API9版本SDK,版本号OpenHarmony3.2 beta3; API与SDK: API Version 9
48本示例需要使用@ohos.multimedia.avsession系统权限的系统接口,使用Full SDK时需要手动从镜像站点获取,并在DevEco Studio中替换,具体操作可参考[替换指南](https://docs.openharmony.cn/pages/v3.2/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md/)
49本示例需要使用IDE: DevEco Studio 3.1 Canary1 Build Version: 3.1.0.100, built on November 3, 2022才可以编译运行
50