鸿蒙媒体开发系列04——音频播放

 如果你也对鸿蒙开发感兴趣，加入“Harmony自习室”吧！扫描下方名片，关注公众号，公众号更新更快，同时也有更多学习资料和技术讨论群。

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

在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后续版本将会推出相关接口来支持该场景。

2、使用AVPlayer开发音频播放功能

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

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

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

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

2.1、开发步骤及注意事项

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

2. 设置业务需要的监听事件，搭配全流程场景使用。支持的监听事件如下：

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

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

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

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

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

2.2、Demo

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

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 isSeek: boolean = true; // 用于区分模式是否支持seek操作  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++;