点击蓝字 ╳ 关注我们
开源项目 OpenHarmony是每个人的 OpenHarmony![880c44d6-5b88-11ed-a3b6-dac502259ad0.png](https://file1.elecfans.com//web2/M00/97/43/wKgZomTnMN6AZ353AA_vv_QUwQE752.png)
马迪欣
OpenHarmony知识体系工作组
以下内容来自嘉宾分享,不代表开放原子开源基金会观点 OpenAtom OpenHarmony(以下简称“OpenHarmony”)应用开发自API 8及其更早版本一直使用的是FA模型进行开发。FA模型是Feature Ability的缩写,它和PA(Particle Ability)两种类型是过往长期推广的术语,深入人心。 然而从API 9开始,Ability框架引入了Stage模型作为第二种应用框架形态,Stage模型将Ability分为PageAbility和ExtensionAbility两大类,其中ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等一系列ExtensionAbility,以便满足更多的使用场景。新模型接口中有AbilityStage/WindowStage的概念,这个Stage本身有舞台的意思,寓意是给开发者一个新的展现舞台。Stage模型的设计,主要是为了开发者更加方便地开发出分布式环境下的复杂应用。下表给出了两种模型在设计上的差异:![88356d8e-5b88-11ed-a3b6-dac502259ad0.png](https://file1.elecfans.com//web2/M00/97/43/wKgZomTnMN6AE4fKAAItWIC5NoI544.png)
![885ce5e4-5b88-11ed-a3b6-dac502259ad0.png](https://file1.elecfans.com//web2/M00/97/43/wKgZomTnMN6AeSuwAAE1d54a4ao612.png)
import featureAbility from '@ohos.ability.featureAbility';
featureAbility.startAbility({
want: wantValue
}).then((data) => {
CommonLog.info('startAbilityContinuation finished, ' + JSON.stringify(data))
//拉起后,自我关闭
featureAbility.terminateSelf((error) => {
CommonLog.info('startAbilityContinuation terminateSelf finished, error=' + JSON.stringify(error))
})
}).catch((error) => {
CommonLog.info('startAbilityContinuation error ' + JSON.stringify(error))
})
而在stage模型里,由于不再有featureAbility,因此无法import featureAbility,进而无法使用featureAbility.startAbility拉起应用,进而使用getContext获取上下文后,调用startAbility拉起应用。 getContext(this).startAbility(want).then((data) => {
CommonLog.info('startAbilityContinuation finished, ' + JSON.stringify(data))
//自我关闭
getContext(this).terminateSelf((error) => {
CommonLog.info('startAbilityContinuation terminateSelf finished, error=' + JSON.stringify(error))
})
}).catch((error) => {
CommonLog.info('startAbilityContinuation error ' + JSON.stringify(error))
})
除了startAbility外,样例里使用到的获取包含bundleName,设备发现deviceManager的相关API都需要按照上述方法进行修改。
修改点3:数据从组件分离,提取到Ability中
在分布式拉起时,需要传递当前播放的音乐和音乐的播放进度。在两种模型里,这些参数都是被设置在wantValue的parameters里,通过startAbility传出去。 let params = {
index: this.playerManager.getCurrentMusicIndex(),
seekTo: this.playerManager.getCurrentTimeMs(),
isPlaying: this.isPlaying
}
let wantValue = {
bundleName: this.bundleName,
abilityName: 'com.madixin.music.MainAbility',
deviceId: remoteDevice.deviceId,
parameters: params
}
但在接收参数时,FA模型里,是在当前组件的代码里,通过featureAbility.getWant来获取参数,如下代码。 featureAbility.getWant((error, want) => {
CommonLog.info('restoreFromWant featureAbility.getWant=' + JSON.stringify(want))
let status = want.parameters
if (status != null && status.index != null) {
this.playerManager.playSpecifyMusic(status.seekTo, status.index)
this.isPlaying = true
this.playAnimation()
}
})
而使用Stage模型后,虽然参数传递的方式是一致的,但是无法直接在组件UI中获取参数,而需要先在MainAbility.ts获取参数want。此时如果要传递给组件,有多种方式,这里我是使用的如下方式,即在MainAbility.ts的onCreate和onNewWant里,把want赋值到globalThis里,然后在UI组件里,通过globalThis获取参数。 // MainAbility.ts
onNewWant(want, launchParams) {
globalThis.newWant = want
hilog.info(0x0000, 'MyOpenHarmonyPlayer', '%{public}s', 'onNewWant launchParam:' + JSON.stringify(launchParams) ?? '');
}
onCreate(want, launchParam) {
globalThis.newWant = want
hilog.info(0x0000, 'MyOpenHarmonyPlayer', '%{public}s', 'want param:' + JSON.stringify(want) ?? '');
hilog.info(0x0000, 'MyOpenHarmonyPlayer', '%{public}s', 'launchParam:' + JSON.stringify(launchParam) ?? '');
}
// index.ets
let newWant = globalThis.newWant
CommonLog.info("aboutToAppear newWant:" + JSON.stringify(newWant))
if (newWant !== null && newWant.parameters.hasOwnProperty("seekTo")) {
this.playerManager.playSpecifyMusic(newWant.parameters.seekTo, newWant.parameters.index)
}
另外,了解到还有一种方式传递数据是使用AppStorage来关联,比如在MainAbility.ts里使用AppStorage.SetOrCreate传入数据,在UI组件里,使用@StorageLink标签修饰变量来获取数据。
除以上三点修改外,还有两点值得说明下
首先是因OpenHarmony 3.2后分布式能力限制智能系统应用使用,需要提升apl等级:找到所使用API版本对应toolchains>版本号>lib>UnsgnedReleasedProfileTemplate.json,更改 "apl": "normal"为 "apl": "system_core"。
其次是API 9以后区分了public-SDK和Full SDK。DevEco Studio默认下载的是public-SDK,它不包含系统应用所需要的高权限API。当我们import deviceManager from '@ohos.distributedHardware.deviceManager'时,会发现里面只有一个空的接口,没有任何方法。虽然这不影响功能,但代码中必须使用@ts-ignore忽略typescript的告警,而且没有语法提示。此时,需要使用full-SDK替换。
相关文档请参考https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/quick-start/full-sdk-switch-guide.md
新增首页页面,和播放列表页的动画,不是本文的重点,大家可以参考代码自行学习。总结
OpenHarmony的FA模型能力已经停止演进,后续将会增强Stage模型。此次将现有的样例代码适配Stage模型,虽然整体代码修改量不大,但因为惯性思维以及API的变化,期间还是踩了不少坑。我已在OpenHarmony知识体系仓中更新了样例代码,欢迎开发者来参考和指正问题,建议新上手OpenHarmony的开发者可以直接学习使用新的Stage模型来开发应用。 前面提到在Stage模型里,ExtensionAbility又被扩展为ServiceExtensionAbility、FormExtensionAbility、DataShareExtensionAbility等一系列ExtensionAbility,这个样例目前还没有涉及到,待后续进一步学习,通过ExtensionAbility把音乐播放实现成一个后台服务,从而实现应用在后台时也能继续播放音乐,届时将持续更新这个应用,也欢迎大家一起共建。 分布式音乐播放器样例地址https://growing.openharmony.cn/mainPlay/detail?sampleId=3742
原文标题:我把分布式音乐播放器适配了Stage模型
文章出处:【微信公众号:OpenAtom OpenHarmony】欢迎添加关注!文章转载请注明出处。
声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。
举报投诉
-
鸿蒙
+关注
关注
57文章
2398浏览量
43138 -
OpenHarmony
+关注
关注
25文章
3753浏览量
16736
原文标题:我把分布式音乐播放器适配了Stage模型
文章出处:【微信号:gh_e4f28cfa3159,微信公众号:OpenAtom OpenHarmony】欢迎添加关注!文章转载请注明出处。
发布评论请先 登录
相关推荐
基于战舰板的遥控音乐播放器
2012年买的战舰板,有较长时间放着吃灰觉得很可惜。感觉战舰板的音乐播放器音质蛮不错的,于是想就折腾一个遥控音乐播放器。貌似很简单的事,实际上我
发表于 07-01 04:35
基于润和DAYU200开发套件的OpenHarmony分布式音乐播放器
RJ45以太网口,可满足NVR、工业网关等多网口产品需求。分布式音乐播放器这里给大家分享一个样例,分布式音乐
发表于 03-14 09:07
DistributedVideoPlayer分布式视频播放器的设计资料
1、DistributedVideoPlayer分布式视频播放器的设计资料(一)本示例是在官方Video Play Ability 模板基础上做了扩展开发,官方模板提供基本的视频播放功能,并允许您在
发表于 03-22 11:55
求一种基于DAYU200开发套件的分布式音乐播放器设计方案
、音频、视频和摄像头等功能,拥有丰富的扩展接口,支持多种视频输入输出接口;配置双千兆自适应RJ45以太网口,可满足NVR、工业网关等多网口产品需求。分布式音乐播放器这里给大家分享一个样例,分布
发表于 09-08 17:22
我把分布式音乐播放器适配了Stage模型
Ability使用一个VM实例,而Stage模型整个进程只使用一个VM实例,减少进程内存占用,应用内状态在进程内共享。分布式音乐播放器,是今
发表于 11-07 11:43
Windows Media Player音乐播放器代码
Windows Media Player音乐播放器代码
一、Windows Media Player音乐播放器代码:
发表于 01-10 11:14
•2287次阅读
基于Android音乐播放器的研究
Android平台是目前智能移动终端的主流系统。随着人们生活、工作节奏的加快,乘车、运动、学习等碎片时间的增多,音乐播放器成为人们所关心的必备应用之一,广受大家欢迎。 目前,Android市场上以酷
发表于 12-11 11:44
•7次下载
![基于Android<b class='flag-5'>音乐</b><b class='flag-5'>播放器</b>的研究](https://file.elecfans.com/web2/M00/49/7A/poYBAGKhwLuAS1jzAAAatSawbTk057.jpg)
鸿蒙HarmonyOS开发实战:【分布式音乐播放】
本示例使用fileIo获取指定音频文件,并通过AudioPlayer完成了音乐的播放完成了基本的音乐播放、暂停、上一曲、下一曲功能;并使用DeviceManager完成了
![鸿蒙HarmonyOS开发实战:【<b class='flag-5'>分布式</b><b class='flag-5'>音乐</b><b class='flag-5'>播放</b>】](https://file1.elecfans.com/web2/M00/C7/CE/wKgZomYWYNyAFSiFAAQDf9vAtiw310.png)
评论