【HarmonyOS】鸿蒙应用实现音效播放

一、标题配景：
应用在强提示场景下，一样平常会有播放音效的效果，提示用户注意力的关注。
在鸿蒙应用怎样实现音效播放呢？？？
二、办理方案：
利用AVPlayer实现当地音效资源的播放。
该播放器功能很丰富，如今只针对于音效播放举行睁开。
播放的全流程包罗：创建AVPlayer，设置播放资源，设置播放参数（音量/倍速/焦点模式），播放控制（播放/停息/跳转/克制），重置，烧毁资源。

开辟详细步调分析：

• 起首创建实例createAVPlayer()，AVPlayer初始化idle状态。
  
• 注册状态厘革回调和错误回调
  
• 加载当地音效文件资源
  
• 设置厘革状态，提供播放接口
  
• 音效文件比力短，默认播放完不做任那边理。若播放长时间音乐文件，可在状态回调里处置惩罚
  

必要注意的是，当音效文件设置完成后，只有调用play才会正常播放。

---

ps: 着实关于音效和振动同时处置惩罚，官方有音振协同的API举行实现，但是该API如今调用资源，比方音效文件和自界说振动设置文件的方式不太友好，不能从应用沙箱raw下读取，以是保举分开实现的方式。

---

三、DEMO示例：
DEMO解说通过表明的方式表明。如有不清楚的点，可关注私信我沟通。
音效播放管理类

1. import { media } from '@kit.MediaKit';
2. import { BusinessError } from '@kit.BasicServicesKit';
4. /**
5. * 音效播放管理类
6. */
7. export class AudioMgr {
8.   private TAG: string = 'AudioMgr';
10.   // 单例对象
11.   private static mAudioMgr: AudioMgr | null = null;
13.   // 播放器实例
14.   private mAVPlayer: media.AVPlayer | undefined = undefined;
16.   // 是否初始化
17.   private isInit: boolean = false;
19.   // 创建单例
20.   public static Ins(): AudioMgr{
21.     if(!AudioMgr.mAudioMgr){
22.       AudioMgr.mAudioMgr = new AudioMgr();
23.     }
24.     return AudioMgr.mAudioMgr;
25.   }
27.   /**
28.    * 初始化接口（可以提前初始化，也可以直接调用play接口，使用时初始化）
29.    */
30.   public async init() {
31.     console.log(this.TAG, "play init start");
32.     // 创建avPlayer实例对象
33.     this.mAVPlayer = await media.createAVPlayer();
34.     // 创建状态机变化回调函数
35.     this.registerStateChange(this.mAVPlayer);
36.     // error回调监听函数,当avPlayer在操作过程中出现错误时调用 reset接口触发重置流程
37.     this.registerErrorCall(this.mAVPlayer);
38.     // 获取raw音效资源
39.     let fileDescriptor = await getContext(this).resourceManager.getRawFd("test.mp3");
40.     this.mAVPlayer.fdSrc = {
41.         fd: fileDescriptor.fd,
42.         offset: fileDescriptor.offset,
43.         length: fileDescriptor.length
44.     };
45.     this.isInit = true;
46.     console.log(this.TAG, "play init end");
47.     return this.mAVPlayer;
48.   }
50.   /**
51.    * 注册异常回调
52.    * @param avPlayer
53.    */
54.   private registerErrorCall(avPlayer: media.AVPlayer){
55.     avPlayer.on('error', (err: BusinessError) => {
56.       console.log(this.TAG, " err:" + JSON.stringify(err));
57.       // 调用reset重置资源，触发idle状态
58.       avPlayer.reset();
59.     })
60.   }
62.   /**
63.    * 注册状态变化回调
64.    * @param avPlayer
65.    */
66.   private registerStateChange(avPlayer: media.AVPlayer){
67.     avPlayer.on('stateChange', async (state: string, reason: media.StateChangeReason) => {
69.       switch (state) {
70.         // 成功调用reset接口后触发该状态机上报
71.         case 'idle':
72.           console.info(this.TAG, 'stateChange idle-release');
73.           avPlayer.release(); // 调用release接口销毁实例对象
74.           break;
76.         // avplayer 设置播放源后触发该状态上报
77.         case 'initialized':
78.           console.info(this.TAG, 'stateChange initialized-prepare');
79.           avPlayer.prepare();
80.           break;
82.         // prepare调用成功后上报该状态机
83.         case 'prepared':
84.           console.info(this.TAG, 'stateChange prepared-setVolume');
85.           avPlayer.setVolume(1); // The value ranges from 0.00 to 1.00.
86.           break;
88.         // play成功调用后触发该状态机上报
89.         case 'playing':
90.           console.info(this.TAG, 'stateChange playing');
91.           break;
93.         // pause成功调用后触发该状态机上报
94.         case 'paused':
95.           console.info(this.TAG, 'stateChange paused');
96.           break;
98.         // 播放结束后触发该状态机上报
99.         case 'completed':
100.           console.info(this.TAG, 'stateChange completed');
101.           break;
103.         // stop接口成功调用后触发该状态机上报
104.         case 'stopped':
105.           console.info(this.TAG, 'stateChange stopped');
106.           // avPlayer.reset(); // 调用reset接口初始化avplayer状态
107.           break;
109.         case 'released':
110.           console.info(this.TAG, 'stateChange released');
111.           break;
113.         default:
114.           console.info(this.TAG, 'stateChange default');
115.           break;
116.       }
117.     });
118.   }
120.   /**
121.    * 播放音效
122.    */
123.   public async play(){
124.     console.log(this.TAG, "play isInit " + this.isInit);
125.     if(this.isInit){
126.       await this.mAVPlayer?.play();
127.     }else{
128.       console.log(this.TAG, "play play-init start");
129.       this.mAVPlayer = await this.init();
130.       console.log(this.TAG, "play play start");
131.       await this.mAVPlayer?.play();
132.       console.log(this.TAG, "play play end");
133.     }
134.   }
136.   /**
137.    * 销毁音效管理工具
138.    */
139.   public async destroy(){
140.     console.log(this.TAG, "play destroy start");
141.     await this.mAVPlayer?.release();
142.     this.mAVPlayer = undefined;
143.     this.isInit = false;
144.     AudioMgr.mAudioMgr = null;
145.     console.log(this.TAG, "play destroy end");
146.   }
148. }

复制代码

音效播放测试页

1. import { promptAction } from '@kit.ArkUI'
2. import { BusinessError } from '@kit.BasicServicesKit';
3. import { AudioMgr } from '../../mgr/AudioMgr';
5. /**
6. * 音效播放
7. */
8. @Entry
9. @Component
10. struct AudioPage {
12.   private TAG: string = "AudioPage";
14.   onClickDestroy= ()=>{
15.     AudioMgr.Ins().destroy();
16.     this.showToast("销毁音效工具！");
17.   }
19.   onClickInit = ()=>{
20.     AudioMgr.Ins().init();
21.     this.showToast("初始化音效工具！");
22.   }
24.   onClickPlay = ()=>{
25.     AudioMgr.Ins().play();
26.     this.showToast("播放音效！");
27.   }
29.   private showToast(content: string){
30.     try {
31.       promptAction.showToast({
32.         message: content,
33.         duration: 2000
34.       });
35.     } catch (error) {
36.       let message = (error as BusinessError).message
37.       let code = (error as BusinessError).code
38.       console.error(this.TAG, `showToast args error code is ${code}, message is ${message}`);
39.     };
40.   }
42.   /**
43.    * 统一样式封装
44.    */
45.   @Styles ButtonStyle(){
46.     .width(px2vp(350))
47.     .height(px2vp(200))
48.     .margin({ top: px2vp(66) })
49.   }
51.   build() {
52.     Column(){
53.       Button("初始化音效工具")
54.         .ButtonStyle()
55.         .onClick(this.onClickInit)
57.       Button("播放音效")
58.         .ButtonStyle()
59.         .onClick(this.onClickPlay)
61.       Button("销毁音效工具")
62.         .ButtonStyle()
63.         .onClick(this.onClickDestroy)
65.     }.size({
66.       width: "100%",
67.       height: "100%"
68.     })
69.   }
71. }

复制代码

添加音频资源文件

https://sc.chinaz.com/yinxiao/23080315806.htm  音频资源可以从这个网站下载。