AudioCapturer:用于音频输入的API,仅支持pcm格式,需要应用持续读取音频数据进行工作。应用可以在音频输出后添加数据处理,要求开发者具备音频处理的基础知识,适用于更专业、更多样化的媒体录制应用开发。
可以使用添加文件头的方法将pcm格式的音频数据封装成wav格式。wav格式的音频可以直接播放。
完整示例参考如下:
import { audio } from '@kit.AudioKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { fileIo as fs } from '@kit.CoreFileKit'; import { abilityAccessCtrl, common, Permissions } from '@kit.AbilityKit'; import { fileIo } from '@kit.CoreFileKit'; const TAG = 'AudioCapturerDemo'; const permissions: Permissions[] = ['ohos.permission.MICROPHONE']; class Options { offset?: number; length?: number; } let audioCapturer: audio.AudioCapturer | 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 audioCapturerInfo: audio.AudioCapturerInfo = { source: audio.SourceType.SOURCE_TYPE_MIC, // 音源类型:Mic音频源。根据业务场景配置,参考SourceType。 capturerFlags: 0 // 音频采集器标志。 }; let audioCapturerOptions: audio.AudioCapturerOptions = { streamInfo: audioStreamInfo, capturerInfo: audioCapturerInfo }; let file: fs.File; let readDataCallback: Callback<ArrayBuffer>; async function initArguments(context: common.UIAbilityContext) { let bufferSize: number = 0; let path = context.cacheDir; let filePath = path + '/StarWars10s-2C-48000-4SW.pcm'; file = fs.openSync(filePath, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE); readDataCallback = (buffer: ArrayBuffer) => { let options: Options = { offset: bufferSize, length: buffer.byteLength }; fs.writeSync(file.fd, buffer, options); bufferSize += buffer.byteLength; }; } // 初始化,创建实例,设置监听事件。 async function init() { audio.createAudioCapturer(audioCapturerOptions, (err, capturer) => { // 创建AudioCapturer实例。 if (err) { console.error(`Invoke createAudioCapturer failed, code is ${err.code}, message is ${err.message}`); return; } console.info(`${TAG}: create AudioCapturer success`); audioCapturer = capturer; if (audioCapturer !== undefined) { audioCapturer.on('readData', readDataCallback); } }); } // 开始一次音频采集。 async function start() { if (audioCapturer !== undefined) { let stateGroup = [audio.AudioState.STATE_PREPARED, audio.AudioState.STATE_PAUSED, audio.AudioState.STATE_STOPPED]; if (stateGroup.indexOf(audioCapturer.state.valueOf()) === -1) { // 当且仅当状态为STATE_PREPARED、STATE_PAUSED和STATE_STOPPED之一时才能启动采集。 console.error(`${TAG}: start failed`); return; } // 启动采集。 audioCapturer.start((err: BusinessError) => { if (err) { console.error('Capturer start failed.'); } else { console.info('Capturer start success.'); } }); } } // 停止采集。 async function stop() { if (audioCapturer !== undefined) { // 只有采集器状态为STATE_RUNNING或STATE_PAUSED的时候才可以停止。 if (audioCapturer.state.valueOf() !== audio.AudioState.STATE_RUNNING && audioCapturer.state.valueOf() !== audio.AudioState.STATE_PAUSED) { console.info('Capturer is not running or paused'); return; } // 停止采集。 audioCapturer.stop((err: BusinessError) => { if (err) { console.error('Capturer stop failed.'); } else { console.info('Capturer stop success.'); } }); } } // 销毁实例,释放资源。 async function release() { if (audioCapturer !== undefined) { // 采集器状态不是STATE_RELEASED或STATE_NEW状态,才能release。 if (audioCapturer.state.valueOf() === audio.AudioState.STATE_RELEASED || audioCapturer.state.valueOf() === audio.AudioState.STATE_NEW) { console.info('Capturer already released'); return; } // 释放资源。 audioCapturer.release((err: BusinessError) => { if (err) { console.error('Capturer release failed.'); } else { fs.closeSync(file); console.info('Capturer release success.'); } }); } } async function requestPermissions(permissions: Permissions[], context: common.UIAbilityContext): Promise<boolean> { let permissionGrant = true; let atManager: abilityAccessCtrl.AtManager = abilityAccessCtrl.createAtManager(); await atManager.requestPermissionsFromUser(context, permissions) .then((data) => { let grantStatus: number[] = data.authResults; let length: number = grantStatus.length; for (let i = 0; i < length; i++) { if (grantStatus[i] === 0) { console.info(`Request ${permissions[i]} succeed`); } else { permissionGrant = false; console.info(`Request ${permissions[i]} rejected`); } } }) .catch((err: BusinessError) => { permissionGrant = false; console.error(`Request permission failed, err: ${JSON.stringify(err)}`); }); return permissionGrant; } @Entry @Component struct Index { private microphoneGranted: boolean = false; context = this.getUIContext().getHostContext() as common.UIAbilityContext; private pcmTranslater = new pcmToWav(this.context); aboutToAppear(): void { requestPermissions(permissions, this.context).then((granted: boolean) => { this.microphoneGranted = granted; console.info(`Microphone Permission Granted ${this.microphoneGranted}`); }); } build() { Scroll() { Column() { Row() { Column() { Text('初始化').fontColor(Color.Black).fontSize(16).margin({ top: 12 }); } .backgroundColor(Color.White) .borderRadius(30) .width('45%') .height('25%') .margin({ right: 12, bottom: 12 }) .onClick(async () => { let context = this.getUIContext().getHostContext() as common.UIAbilityContext; initArguments(context); init(); }); Column() { Text('开始录制').fontColor(Color.Black).fontSize(16).margin({ top: 12 }); } .backgroundColor(Color.White) .borderRadius(30) .width('45%') .height('25%') .margin({ bottom: 12 }) .onClick(async () => { start(); }); }; Row() { Column() { Text('停止录制').fontSize(16).margin({ top: 12 }); } .id('audio_effect_manager_card') .backgroundColor(Color.White) .borderRadius(30) .width('45%') .height('25%') .margin({ right: 12, bottom: 12 }) .onClick(async () => { stop(); }); Column() { Text('释放资源').fontColor(Color.Black).fontSize(16).margin({ top: 12 }); } .backgroundColor(Color.White) .borderRadius(30) .width('45%') .height('25%') .margin({ bottom: 12 }) .onClick(async () => { release(); }); } .padding(12); Button('PCM转码WAV') .width('100%') .onClick(async () => { let filepath = this.context.cacheDir + '/StarWars10s-2C-48000-4SW.pcm'; await this.pcmTranslater.pcmTranslate(filepath); }); } .height('100%') .width('100%') .backgroundColor('#F1F3F5'); }; } } interface WavHeader { riff: string, fileSize: number, wave: string, fmtChunkMarker: string, fmtSize: number, formatType: number, channels: number, sampleRate: number, byteRate: number, blockAlign: number, bitsPerSample: number, dataChunkMarker: string, dataSize: number }; // pcm转wav工具类 class pcmToWav { private context: Context; constructor(context: Context) { this.context = context; } // wav文件需要的文件头 waveHeader: WavHeader = { riff: 'RIFF', // "RIFF" fileSize: 0, // 文件大小减去8 wave: 'WAVE', // ”WAVE“ fmtChunkMarker: 'fmt ', // "fmt " fmtSize: 16, // 16 formatType: 1, // 1(表示PCM) channels: 2, // 声道数 sampleRate: 48000, // 采样率 byteRate: 48000 * 2 * 2, // 每秒字节数(SampleRate * Channels * BitsPerSample / 8) blockAlign: 2 * 2, // 帧大小(channels * BitsPerSample / 8) bitsPerSample: 16, // 采样位数 dataChunkMarker: 'data', // ”data“ dataSize: 0, // 数据大小 }; setString(idx: number, str: string, view: DataView) { for (let i = 0; i < str.length; i++) { view.setInt8(idx++, str.charCodeAt(i)); } } /** * 为pcm文件封装wav头 * @param pcmFilePath 保存录制的pcm数据的沙箱文件路径 */ async pcmTranslate(pcmFilePath: string) { // 创建一个大小为44字节的缓冲区,用于存储wav文件的头部信息,再将其写入输出文件 let fileSize = 0; try { fileSize = fileIo.statSync(pcmFilePath).size; } catch (err) { console.error(`failed to get file size, ${JSON.stringify(err)}`); } this.waveHeader.fileSize = fileSize + 44 - 8; this.waveHeader.dataSize = fileSize; let idx: number = 0; let buffer: ArrayBuffer = new ArrayBuffer(44); let bufferView: DataView = new DataView(buffer); // riff this.setString(idx, this.waveHeader.riff, bufferView); idx += 4; // file size bufferView.setInt32(idx, this.waveHeader.fileSize, true); idx += 4; // wave this.setString(idx, this.waveHeader.wave, bufferView); idx += 4; // fmt this.setString(idx, this.waveHeader.fmtChunkMarker, bufferView); idx += 4; // fmt size bufferView.setInt32(idx, this.waveHeader.fmtSize, true); idx += 4; // format type bufferView.setInt16(idx, this.waveHeader.formatType, true); idx += 2; // channels bufferView.setInt16(idx, this.waveHeader.channels, true); idx += 2; // sample rate bufferView.setInt32(idx, this.waveHeader.sampleRate, true); idx += 4; // byte rate bufferView.setInt32(idx, this.waveHeader.byteRate, true); idx += 4; // block align bufferView.setInt16(idx, this.waveHeader.blockAlign, true); idx += 2; // bits per sample bufferView.setInt16(idx, this.waveHeader.bitsPerSample, true); idx += 2; // data this.setString(idx, this.waveHeader.dataChunkMarker, bufferView); idx += 4; // data size bufferView.setInt32(idx, this.waveHeader.dataSize, true); // 将PCM数据从输入文件写入输出文件,使用fs.readSync读取输入文件的数据,并写入输出文件,直到读取完毕 let path = this.context.filesDir + '/output.wav'; // output wav file path let inputFile: fileIo.File | undefined; let outputFile: fileIo.File | undefined; try { inputFile = fileIo.openSync(pcmFilePath, fileIo.OpenMode.READ_ONLY); outputFile = fileIo.openSync(path, fileIo.OpenMode.CREATE | fileIo.OpenMode.TRUNC | fileIo.OpenMode.WRITE_ONLY); // write wav header fileIo.writeSync(outputFile.fd, buffer); // write pcm data let readSize = 0; let readBuf = new ArrayBuffer(1024 * 1024); do { readSize = fileIo.readSync(inputFile.fd, readBuf); fileIo.writeSync(outputFile.fd, readBuf, { length: readSize }); } while (readSize > 0); } catch (err) { console.error(`Failed to write file, ${JSON.stringify(err)}`); } finally { if (inputFile) { fileIo.closeSync(inputFile); } if (outputFile) { fileIo.closeSync(outputFile); } } } }