写点什么

HarmonyOS 音频开发指导:使用 AVPlayer 开发音频播放功能

  • 2023-10-19
    北京
  • 本文字数:3699 字

    阅读完需:约 12 分钟

HarmonyOS音频开发指导:使用AVPlayer开发音频播放功能

如何选择音频播放开发方式

在 HarmonyOS 系统中,多种 API 都提供了音频播放开发的支持,不同的 API 适用于不同音频数据格式、音频资源来源、音频使用场景,甚至是不同开发语言。因此,选择合适的音频播放 API,有助于降低开发工作量,实现更佳的音频播放效果。


● AVPlayer:功能较完善的音频、视频播放 ArkTS/JS API,集成了流媒体和本地资源解析、媒体资源解封装、音频解码和音频输出功能。可以用于直接播放 mp3、m4a 等格式的音频文件,不支持直接播放 PCM 格式文件。


● AudioRenderer:用于音频输出的的 ArkTS/JS API,仅支持 PCM 格式,需要应用需要持续写入音频数据进行工作。应用可以在输入前添加数据预处理,如设定音频文件的采样率、位宽等,要求开发者具备音频处理的基础知识,适用于更专业、更多样化的媒体播放应用开发。


● OpenSL ES:一套跨平台标准化的音频 Native API,目前阶段唯一的音频类 Native API,同样提供音频输出能力,仅支持 PCM 格式,适用于从其他嵌入式平台移植,或依赖在 Native 层实现音频输出功能的播放应用使用。


● 在音频播放中,应用时常需要用到一些急促简短的音效,如相机快门音效、按键音效、游戏射击音效等,当前只能使用 AVPlayer 播放音频文件替代实现,在 HarmonyOS 后续版本将会推出相关接口来支持该场景。

使用 AVPlayer 开发音频播放功能

使用 AVPlayer 可以实现端到端播放原始媒体资源,本开发指导将以完整地播放一首音乐作为示例,向开发者讲解 AVPlayer 音频播放相关功能。


播放的全流程包含:创建 AVPlayer,设置播放资源,设置播放参数(音量/倍速/焦点模式),播放控制(播放/暂停/跳转/停止),重置,销毁资源。


在进行应用开发的过程中,开发者可以通过 AVPlayer 的 state 属性主动获取当前状态或使用 on('stateChange')方法监听状态变化。如果应用在音频播放器处于错误状态时执行操作,系统可能会抛出异常或生成其他未定义的行为。


图 1 播放状态变化示意图



状态的详细说明请参考AVPlayerState。当播放处于 prepared / playing / paused / completed 状态时,播放引擎处于工作状态,这需要占用系统较多的运行内存。当客户端暂时不使用播放器时,调用 reset()或 release()回收内存资源,做好资源利用。

开发步骤及注意事项

详细的 API 说明请参考AVPlayer API参考

1.  创建实例 createAVPlayer(),AVPlayer 初始化 idle 状态。

2.  设置业务需要的监听事件,搭配全流程场景使用。支持的监听事件包括:



3.  设置资源:设置属性 url,AVPlayer 进入 initialized 状态。

说明

下面代码示例中的 url 仅作示意使用,开发者需根据实际情况,确认资源有效性并设置:

a.  如果使用本地资源播放,必须确认资源文件可用,并使用应用沙箱路径访问对应资源,参考获取应用文件路径。应用沙箱的介绍及如何向应用沙箱推送文件,请参考文件管理

b.  如果使用网络播放路径,需申请相关权限:ohos.permission.INTERNET。

c.  如果使用 ResourceManager.getRawFd 打开 HAP 资源文件描述符,使用方法可参考ResourceManager API参考

d.  需要使用支持的播放格式与协议

4.  准备播放:调用 prepare(),AVPlayer 进入 prepared 状态,此时可以获取 duration,设置音量。

5.  音频播控:播放 play(),暂停 pause(),跳转 seek(),停止 stop() 等操作。

6.  (可选)更换资源:调用 reset()重置资源,AVPlayer 重新进入 idle 状态,允许更换资源 url。

7.  退出播放:调用 release()销毁实例,AVPlayer 进入 released 状态,退出播放。

完整示例

参考以下示例,完整地播放一首音乐。


import media from '@ohos.multimedia.media';import fs from '@ohos.file.fs';import common from '@ohos.app.ability.common';
export class AVPlayerDemo { private avPlayer; private count: number = 0;
// 注册avplayer回调函数 setAVPlayerCallback() { // seek操作结果回调函数 this.avPlayer.on('seekDone', (seekDoneTime) => {      console.info(`AVPlayer seek succeeded, seek time is ${seekDoneTime}`); }) // error回调监听函数,当avPlayer在操作过程中出现错误时调用reset接口触发重置流程 this.avPlayer.on('error', (err) => {      console.error(`Invoke avPlayer failed, code is ${err.code}, message is ${err.message}`); this.avPlayer.reset(); // 调用reset重置资源,触发idle状态 }) // 状态机变化回调函数 this.avPlayer.on('stateChange', async (state, reason) => { switch (state) {        case 'idle': // 成功调用reset接口后触发该状态机上报          console.info('AVPlayer state idle called.'); this.avPlayer.release(); // 调用release接口销毁实例对象 break;        case 'initialized': // avplayer 设置播放源后触发该状态上报          console.info('AVPlayerstate initialized called.'); this.avPlayer.prepare().then(() => {            console.info('AVPlayer prepare succeeded.'); }, (err) => {            console.error(`Invoke prepare failed, code is ${err.code}, message is ${err.message}`); }); break;        case 'prepared': // prepare调用成功后上报该状态机          console.info('AVPlayer state prepared called.'); this.avPlayer.play(); // 调用播放接口开始播放 break;        case 'playing': // play成功调用后触发该状态机上报          console.info('AVPlayer state playing called.'); if (this.count !== 0) {            console.info('AVPlayer start to seek.'); this.avPlayer.seek(this.avPlayer.duration); //seek到音频末尾 } else { this.avPlayer.pause(); // 调用暂停接口暂停播放 } this.count++; break;        case 'paused': // pause成功调用后触发该状态机上报          console.info('AVPlayer state paused called.'); this.avPlayer.play(); // 再次播放接口开始播放 break;        case 'completed': // 播放结束后触发该状态机上报          console.info('AVPlayer state completed called.'); this.avPlayer.stop(); //调用播放结束接口 break;        case 'stopped': // stop接口成功调用后触发该状态机上报          console.info('AVPlayer state stopped called.'); this.avPlayer.reset(); // 调用reset接口初始化avplayer状态 break;        case 'released':          console.info('AVPlayer state released called.'); break;        default:          console.info('AVPlayer state unknown called.'); break; } }) }
// 以下demo为使用fs文件系统打开沙箱地址获取媒体文件地址并通过url属性进行播放示例  async avPlayerUrlDemo() { // 创建avPlayer实例对象 this.avPlayer = await media.createAVPlayer(); // 创建状态机变化回调函数 this.setAVPlayerCallback();    let fdPath = 'fd://'; // 通过UIAbilityContext获取沙箱地址filesDir,以下为Stage模型获方式,如需在FA模型上获取请参考《访问应用沙箱》获取地址    let context = getContext(this) as common.UIAbilityContext;    let pathDir = context.filesDir;    let path = pathDir + '/01.mp3'; // 打开相应的资源文件地址获取fd,并为url赋值触发initialized状态机上报    let file = await fs.open(path);    fdPath = fdPath + '' + file.fd; this.avPlayer.url = fdPath; }
// 以下demo为使用资源管理接口获取打包在HAP内的媒体资源文件并通过fdSrc属性进行播放示例  async avPlayerFdSrcDemo() { // 创建avPlayer实例对象 this.avPlayer = await media.createAVPlayer(); // 创建状态机变化回调函数 this.setAVPlayerCallback(); // 通过UIAbilityContext的resourceManager成员的getRawFd接口获取媒体资源播放地址 // 返回类型为{fd,offset,length},fd为HAP包fd地址,offset为媒体资源偏移量,length为播放长度    let context = getContext(this) as common.UIAbilityContext;    let fileDescriptor = await context.resourceManager.getRawFd('01.mp3'); // 为fdSrc赋值触发initialized状态机上报 this.avPlayer.fdSrc = fileDescriptor; }}
复制代码


用户头像

每一位开发者都是华为要汇聚的星星之火 2021-10-15 加入

提供HarmonyOS关键技术解析、版本更新、开发者实践和活动资讯,欢迎各位开发者加入HarmonyOS生态,一起创造无限可能!

评论

发布
暂无评论
HarmonyOS音频开发指导:使用AVPlayer开发音频播放功能_HarmonyOS_HarmonyOS开发者_InfoQ写作社区