2024年最新AudioRenderer开发音频播放功能(ArkTS)，HarmonyOS鸿蒙基础学习教程

作者：黑客灵魂 | 2024-06-30 20:38:18

踩

audiorenderer

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化的资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

console.info('Renderer released.');
1

}
});


#### 完整示例


下面展示了使用AudioRenderer渲染音频文件的示例代码。



1
2
3
4
5
6
7
8

import audio from ‘@ohos.multimedia.audio’;
import fs from ‘@ohos.file.fs’;

const TAG = ‘AudioRendererDemo’;

let context = getContext(this);
let renderModel: audio.AudioRenderer | undefined = undefined;
let audioStreamInfo: audio.AudioStreamInfo = {
samplingRate: audio.AudioSamplingRate.SAMPLE_RATE_48000, // 采样率
channels: audio.AudioChannel.CHANNEL_2, // 通道
sampleFormat: audio.AudioSampleFormat.SAMPLE_FORMAT_S16LE, // 采样格式
encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW // 编码格式
}
let audioRendererInfo: audio.AudioRendererInfo = {
usage: audio.StreamUsage.STREAM_USAGE_MUSIC, // 音频流使用类型
rendererFlags: 0 // 音频渲染器标志
}
let audioRendererOptions: audio.AudioRendererOptions = {
streamInfo: audioStreamInfo,
rendererInfo: audioRendererInfo
}

// 初始化，创建实例，设置监听事件
async function init() {
audio.createAudioRenderer(audioRendererOptions, (err, renderer) => { // 创建AudioRenderer实例
if (!err) {
console.info(${TAG}: creating AudioRenderer success);
renderModel = renderer;
if (renderModel !== undefined) {
(renderModel as audio.AudioRenderer).on(‘stateChange’, (state: audio.AudioState) => { // 设置监听事件，当转换到指定的状态时触发回调
if (state == 2) {
console.info(‘audio renderer state is: STATE_RUNNING’);
}
});
(renderModel as audio.AudioRenderer).on(‘markReach’, 1000, (position: number) => { // 订阅markReach事件，当渲染的帧数达到1000帧时触发回调
if (position == 1000) {
console.info(‘ON Triggered successfully’);
}
});
}
} else {
console.info(${TAG}: creating AudioRenderer failed, error: ${err.message});
}
});
}

// 开始一次音频渲染
async function start() {
if (renderModel !== undefined) {
let stateGroup = [audio.AudioState.STATE_PREPARED, audio.AudioState.STATE_PAUSED, audio.AudioState.STATE_STOPPED];
if (stateGroup.indexOf((renderModel as audio.AudioRenderer).state.valueOf()) === -1) { // 当且仅当状态为prepared、paused和stopped之一时才能启动渲染
console.error(TAG + ‘start failed’);
return;
}
await (renderModel as audio.AudioRenderer).start(); // 启动渲染

const bufferSize = await (renderModel as audio.AudioRenderer).getBufferSize();

let path = context.filesDir;
const filePath = path + '/test.wav'; // 使用沙箱路径获取文件，实际路径为/data/storage/el2/base/haps/entry/files/test.wav

let file = fs.openSync(filePath, fs.OpenMode.READ_ONLY);
let stat = await fs.stat(filePath);
let buf = new ArrayBuffer(bufferSize);
let len = stat.size % bufferSize === 0 ? Math.floor(stat.size / bufferSize) : Math.floor(stat.size / bufferSize + 1);
class Options {
  offset: number = 0;
  length: number = 0
}
for (let i = 0; i < len; i++) {
  let options: Options = {
    offset: i * bufferSize,
    length: bufferSize
  };
  let readsize = await fs.read(file.fd, buf, options);
  
  // buf是要写入缓冲区的音频数据，在调用AudioRenderer.write()方法前可以进行音频数据的预处理，实现个性化的音频播放功能，AudioRenderer会读出写入缓冲区的音频数据进行渲染
  
  let writeSize: number = await (renderModel as audio.AudioRenderer).write(buf);
    if ((renderModel as audio.AudioRenderer).state.valueOf() === audio.AudioState.STATE_RELEASED) { // 如果渲染器状态为released，关闭资源
    fs.close(file);
  }
  if ((renderModel as audio.AudioRenderer).state.valueOf() === audio.AudioState.STATE_RUNNING) {
    if (i === len - 1) { // 如果音频文件已经被读取完，停止渲染
      fs.close(file);
      await (renderModel as audio.AudioRenderer).stop();
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

}
}

// 暂停渲染
async function pause() {
if (renderModel !== undefined) {
// 只有渲染器状态为running的时候才能暂停
if ((renderModel as audio.AudioRenderer).state.valueOf() !== audio.AudioState.STATE_RUNNING) {
console.info(‘Renderer is not running’);
return;
}
await (renderModel as audio.AudioRenderer).pause(); // 暂停渲染
if ((renderModel as audio.AudioRenderer).state.valueOf() === audio.AudioState.STATE_PAUSED) {
console.info(‘Renderer is paused.’);
} else {
console.error(‘Pausing renderer failed.’);
}
}
}

// 停止渲染
async function stop() {
if (renderModel !== undefined) {
// 只有渲染器状态为running或paused的时候才可以停止
if ((renderModel as audio.AudioRenderer).state.valueOf() !== audio.AudioState.STATE_RUNNING && (renderModel as audio.AudioRenderer).state.valueOf() !== audio.AudioState.STATE_PAUSED) {
console.info(‘Renderer is not running or paused.’);
return;
}
await (renderModel as audio.AudioRenderer).stop(); // 停止渲染
if ((renderModel as audio.AudioRenderer).state.valueOf() === audio.AudioState.STATE_STOPPED) {
console.info(‘Renderer stopped.’);
} else {
console.error(‘Stopping renderer failed.’);
}
}
}

// 销毁实例，释放资源
async function release() {
if (renderModel !== undefined) {
// 渲染器状态不是released状态，才能release
if (renderModel.state.valueOf() === audio.AudioState.STATE_RELEASED) {
console.info(‘Renderer already released’);
return;
}
await renderModel.release(); // 释放资源
if (renderModel.state.valueOf() === audio.AudioState.STATE_RELEASED) {
console.info(‘Renderer released’);
} else {
console.error(‘Renderer release failed.’);
}
}
}


当同优先级或高优先级音频流要使用输出设备时，当前音频流会被中断，应用可以自行响应中断事件并做出处理。具体的音频并发处理方式可参考[多音频播放的并发策略](/openharmony/docs/blob/master/zh-cn/application-dev/media/audio-playback-concurrency.md)。


**为了能让大家更好的学习鸿蒙（HarmonyOS NEXT）开发技术，这边特意整理了《鸿蒙开发学习手册》（共计890页），希望对大家有所帮助：[`https://qr21.cn/FV7h05`]( )**


#### 《鸿蒙开发学习手册》：[`https://qr21.cn/FV7h05`]( )


**入门必看：[`https://qr21.cn/FV7h05`]( )**


1. 应用开发导读(ArkTS)
2. ……


![](https://img-blog.csdnimg.cn/img_convert/eab12aefc653b953c5f677e4be4e7a98.webp?x-oss-process=image/format,png)


**HarmonyOS 概念：[`https://qr21.cn/FV7h05`]( )**


1. 系统定义
2. 技术架构
3. 技术特性
4. 系统安全


![](https://img-blog.csdnimg.cn/img_convert/07faa31ade475b8c5afbb4d4b74e7c04.webp?x-oss-process=image/format,png)


**如何快速入门：[`https://qr21.cn/FV7h05`]( )**


1. 基本概念
2. 构建第一个ArkTS应用
3. 构建第一个JS应用
4. ……


![](https://img-blog.csdnimg.cn/img_convert/ccf8d7bc210bffd0d22ed3f462a887e7.webp?x-oss-process=image/format,png)


**开发基础知识：[`https://qr21.cn/FV7h05`]( )**


1. 应用基础知识
2. 配置文件
3. 应用数据管理
4. 应用安全管理
5. 应用隐私保护
6. 三方应用调用管控机制
7. 资源分类与访问
8. 学习ArkTS语言
9. ……


![](https://img-blog.csdnimg.cn/img_convert/23ebda4e6ccfdab179a8be2f256079ac.webp?x-oss-process=image/format,png)


**基于ArkTS 开发：[`https://qr21.cn/FV7h05`]( )**


1. Ability开发
2. UI开发
3. 公共事件与通知
4. 窗口管理
5. 媒体
6. 安全
7. 网络与链接
8. 电话服务
9. 数据管理
10. 后台任务(Background Task)管理


![img](https://img-blog.csdnimg.cn/img_convert/c386b51edb42e6f56791808c2d5675b3.png)
![img](https://img-blog.csdnimg.cn/img_convert/fbe386fbae1762a25046459e5b7ab2d8.png)

**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化的资料的朋友，可以戳这里获取](https://bbs.csdn.net/topics/618636735)**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**

5705105254)]

**网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。**

**[需要这份系统化的资料的朋友，可以戳这里获取](https://bbs.csdn.net/topics/618636735)**


**一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！**

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/黑客灵魂/article/detail/773914