方案选择
如何选择音频播放开发方式
- [AudioRenderer]:用于音频输出的ArkTS/JS API,仅支持PCM格式,需要应用持续写入音频数据进行工作。应用可以在输入前添加数据预处理,如设定音频文件的采样率、位宽等,要求开发者具备音频处理的基础知识,适用于更专业、更多样化的媒体播放应用开发。
- [AVPlayer]:用于音频播放的ArkTS/JS API,集成了流媒体和本地资源解析、媒体资源解封装、音频解码和音频输出功能。可用于直接播放wav、mp3、m4a等格式的音频文件。
在播放音频方面用的最多的就是系统提供的AudioRenderer和AVPlayer。AudioRenderer是音频渲染器,用于播放PCM(Pulse Code Modulation)音频数据,相比AVPlayer而言,可以在输入前添加数据预处理,更适合有音频开发经验的开发者,以实现更灵活的播放功能。使用AudioRenderer播放音频涉及到AudioRenderer实例的创建、音频渲染参数的配置、渲染的开始与停止、资源的释放等。
方案描述
使用AudioRenderer播放音频
配置音频渲染参数并创建AudioRenderer实例。在创建AudioRenderer实例之前可以先设置音频流信息AudioStreamInfo,音频流信息如下:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
samplingRate | [AudioSamplingRate] | 是 | 音频文件的采样率。 |
channels | [AudioChannel] | 是 | 音频文件的通道数。 |
sampleFormat | [AudioSampleFormat] | 是 | 音频采样格式。 |
encodingType | [AudioEncodingType] | 是 | 音频编码类型。 |
其中编码模式只支持PCM编码,所以代码里默认是ENCODING_TYPE_RAW。
然后是设置音频渲染器信息,音频渲染器信息如下:
名称 | 类型 | 必填 | 说明 |
---|---|---|---|
usage | [StreamUsage] | 是 | 音频流使用类型。 |
rendererFlags | [number] | 是 | 音频文件的通道数。 |
其中rendererFlags,0代表普通音频渲染器,1代表低时延音频渲染器。ArkTS接口暂不支持低时延音频渲染器,所以默认为0。
let audioStreamInfo: audio.AudioStreamInfo = {
samplingRate: audio.AudioSamplingRate[this.samplingRate], // 采样率
channels: audio.AudioChannel[this.channels], // 通道
sampleFormat: audio.AudioSampleFormat[this.sampleFormat], // 采样格式
encodingType: audio.AudioEncodingType.ENCODING_TYPE_RAW // 编码格式
}
let audioRendererInfo: audio.AudioRendererInfo = {
usage: audio.StreamUsage[this.usage], // 音频流使用类型
rendererFlags: 0 // 音频渲染器标志
}
let audioRendererOptions: audio.AudioRendererOptions = {
streamInfo: audioStreamInfo,
rendererInfo: audioRendererInfo
}
select提供下拉选择菜单,可以让用户在多个选项之间选择,和text组件一起使用就可以实现让用户自由选择配置信息的能力,这里以采样率下拉菜单为例子。
Text('采样率')
.fontSize(16)
.fontWeight(FontWeight.Bold)
.textAlign(TextAlign.End)
.margin({ right: 4 })
Select([{ value: 'SAMPLE_RATE_8000' },
{ value: 'SAMPLE_RATE_11025' },
{ value: 'SAMPLE_RATE_12000' },
{ value: 'SAMPLE_RATE_16000' },
{ value: 'SAMPLE_RATE_22050' },
{ value: 'SAMPLE_RATE_24000' },
{ value: 'SAMPLE_RATE_32000' },
{ value: 'SAMPLE_RATE_44100' },
{ value: 'SAMPLE_RATE_48000' },
{ value: 'SAMPLE_RATE_64000' },
{ value: 'SAMPLE_RATE_88200' },
{ value: 'SAMPLE_RATE_96000' },
{ value: 'SAMPLE_RATE_176400' },
{ value: 'SAMPLE_RATE_192000' },])
.selected(this.index)
.value(this.samplingRate)
.font({ size: 16, weight: 500 })
.fontColor('#182431')
.selectedOptionFont({ size: 16, weight: 400 })
.optionFont({ size: 16, weight: 400 })
.space(this.space)
.arrowPosition(this.arrowPosition)
.menuAlign(MenuAlignType.START, { dx: 0, dy: 0 })
.optionWidth(200)
.optionHeight(300)
.onSelect((index: number, text?: string | undefined) => {
console.info('Select:' + index)
this.index = index;
if (text) {
this.samplingRate = text;
if (samplingRateData.get(this.samplingRate)) {
this.samplingRate1 = samplingRateData.get(this.samplingRate)
}
}
})
- 调用on(‘writeData’)方法,订阅监听音频数据写入回调。
import { BusinessError } from '@ohos.base';
import fs from '@ohos.file.fs';
let bufferSize: number = 0;
class Options {
offset?: number;
length?: number;
}
let path = getContext().cacheDir;
//确保该路径下存在该资源
let filePath = path + '/result_48000_1.pcm';
let file: fs.File = fs.openSync(filePath, fs.OpenMode.READ_ONLY);
let writeDataCallback = (buffer: ArrayBuffer) => {
let options: Options = {
offset: bufferSize,
length: buffer.byteLength
}
fs.readSync(file.fd, buffer, options);
bufferSize += buffer.byteLength;
}
audioRenderer.on('writeData', writeDataCallback);
- 调用start()方法进入running状态,开始渲染音频。
import { BusinessError } from '@ohos.base';
audioRenderer.start((err: BusinessError) => {
if (err) {
console.error(`Renderer start failed, code is ${err.code}, message is ${err.message}`);
} else {
console.info('Renderer start success.');
}
});
- 调用stop()方法停止渲染。
import { BusinessError } from '@ohos.base';
audioRenderer.stop((err: BusinessError) => {
if (err) {
console.error(`Renderer stop failed, code is ${err.code}, message is ${err.message}`);
} else {
console.info('Renderer stopped.');
}
});
- 调用release()方法销毁实例,释放资源。
import { BusinessError } from '@ohos.base';
audioRenderer.release((err: BusinessError) => {
if (err) {
console.error(`Renderer release failed, code is ${err.code}, message is ${err.message}`);
} else {
console.info('Renderer released.');
}
});
select下拉菜单的展示效果图
以上就是本篇文章所带来的鸿蒙开发中一小部分技术讲解;想要学习完整的鸿蒙全栈技术。可以在结尾找我可全部拿到!
下面是鸿蒙的完整学习路线,展示如下:
除此之外,根据这个学习鸿蒙全栈学习路线,也附带一整套完整的学习【文档+视频】,内容包含如下:
内容包含了:(ArkTS、ArkUI、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、鸿蒙南向开发、鸿蒙项目实战)等技术知识点。帮助大家在学习鸿蒙路上快速成长!
鸿蒙【北向应用开发+南向系统层开发】文档
鸿蒙【基础+实战项目】视频
鸿蒙面经
为了避免大家在学习过程中产生更多的时间成本,对比我把以上内容全部放在了↓↓↓想要的可以自拿喔!谢谢大家观看!