HarmonyOS-鸿蒙app开发 —基于java音频播放开发指导

使用创建的音频流构建音频播放的参数结构AudioRendererInfo，推荐使用AudioRendererInfo.Builder类来构造，模板如下，模板中设置的均为AudioRendererInfo.Builder类的默认值，根据音频播放的具体规格来设置具体参数。

AudioRendererInfo audioRendererInfo = new AudioRendererInfo.Builder().audioStreamInfo(audioStreamInfo)
.audioStreamOutputFlag(AudioRendererInfo.AudioStreamOutputFlag.AUDIO_STREAM_OUTPUT_FLAG_NONE)
.bufferSizeInBytes(0)
.isOffload(false)
.sessionID(AudioRendererInfo.SESSION_ID_UNSPECIFIED)
.build();

以真实的播放pcm流为例：

AudioRendererInfo audioRendererInfo = new AudioRendererInfo.Builder().audioStreamInfo(audioStreamInfo)
.audioStreamOutputFlag(AudioRendererInfo.AudioStreamOutputFlag.AUDIO_STREAM_OUTPUT_FLAG_DIRECT_PCM) // pcm格式的输出流
.bufferSizeInBytes(100)
.isOffload(false) // false表示分段传输buffer并播放，true表示整个音频流一次性传输到HAL层播放
.build();

1. 根据要播放音频流指定PlayMode，不同的PlayMode在写数据时存在差异，详情见步骤7，其余播放流程是无区别的。并通过构造函数获取AudioRenderer类的实例化对象。
2. 使用构造函数获取AudioRenderer类的实例化对象，其中步骤2、步骤3中的数据为构造函数的必选参数，指定播放设备为可选参数，根据使用场景选择不同的构造函数。
3. （可选）构造音频播放回调，首先构造对象AudioInterrupt，其中setInterruptListener方法的入参需要实现接口类InterruptListener，setStreamInfo方法使用步骤1的AudioStreamInfo作为入参。然后调用AudioManager类的activateAudioInterrupt(AudioInterrupt interrupt)方法进行音频播放回调注册。代码示例如下：

AudioRenderer renderer = new AudioRenderer(audioRendererInfo, AudioRenderer.PlayMode.MODE_STREAM);
AudioInterrupt audioInterrupt = new AudioInterrupt();
AudioManager audioManager = new AudioManager();
audioInterrupt.setStreamInfo(audioStreamInfo);
audioInterrupt.setInterruptListener(new AudioInterrupt.InterruptListener() {
@Override
public void onInterrupt(int type, int hint) {
if (type == AudioInterrupt.INTERRUPT_TYPE_BEGIN
&& hint == AudioInterrupt.INTERRUPT_HINT_PAUSE) {
renderer.pause();
} else if (type == AudioInterrupt.INTERRUPT_TYPE_BEGIN
&& hint == AudioInterrupt.INTERRUPT_HINT_NONE) {

} else if (type == AudioInterrupt.INTERRUPT_TYPE_END && (
hint == AudioInterrupt.INTERRUPT_HINT_NONE
|| hint == AudioInterrupt.INTERRUPT_HINT_RESUME)) {
renderer.start();
} else {
HiLog.warn(TAG, “unexpected type or hint”);
}
}
});
audioManager.activateAudioInterrupt(audioInterrupt);

调用AudioRenderer实例化对象的start()方法启动播放任务。

AudioRenderer renderer = new AudioRenderer(audioRendererInfo, AudioRenderer.PlayMode.MODE_STREAM);
renderer.start();

将要播放的音频数据读取为byte流或short流，对于选择MODE_STREAM模式的PlayMode，需要循环调用write方法进行数据写入。对于选择MODE_STATIC模式的PlayMode，只能通过调用一次write方法将要播放的音频数据全部写入，因此该模式限制在文件规格较小的音频数据播放场景下才能使用。

AudioRenderer renderer = new AudioRenderer(audioRendererInfo, AudioRenderer.PlayMode.MODE_STREAM);
String Path = “resources/***/***.pcm”; // 自定义pcm文件
BufferedInputStream bis1 = null;
try {
RawFileDescriptor rawFileDescriptor = getResourceManager().getRawFileEntry(Path).openRawFileDescriptor();
FileDescriptor fileDescriptor1 = rawFileDescriptor.getFileDescriptor();
bis1 = new BufferedInputStream(new FileInputStream(fileDescriptor1));
int minBufferSize = renderer.getMinBufferSize(44100, AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT,
AudioStreamInfo.ChannelMask.CHANNEL_OUT_STEREO);
byte[] buffers = new byte[minBufferSize];
while ((bis1.read(buffers)) != -1) {
boolean write1 = renderer.write(buffers, 0, buffers.length);
renderer.flush();
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (bis1!=null){
try {
bis1.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}

BufferedInputStream bis2 = null;
try {
RawFileDescriptor rawFileDescriptor = getResourceManager().getRawFileEntry(Path).openRawFileDescriptor();
FileDescriptor fileDescriptor1 = rawFileDescriptor.getFileDescriptor();
bis2 = new BufferedInputStream(new FileInputStream(fileDescriptor1));
int minBufferSize = renderer.getMinBufferSize(44100, AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT,
AudioStreamInfo.ChannelMask.CHANNEL_OUT_STEREO);
byte[] buffers = new byte[minBufferSize];
int len ;
while ((len = bis2.read(buffers)) != -1) {
short[] shorts = new short[len];
boolean write2 = renderer.write(shorts, 0, shorts.length);
renderer.flush();
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (bis2!=null){
try {
bis2.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}

AudioRenderer renderer1 = new AudioRenderer(audioRendererInfo, AudioRenderer.PlayMode.MODE_STATIC);
String Path1 = “resources/***/***.pcm”;
BufferedInputStream bis3 = null;
try {
RawFileDescriptor rawFileDescriptor = getResourceManager().getRawFileEntry(Path1).openRawFileDescriptor();
FileDescriptor fileDescriptor1 = rawFileDescriptor.getFileDescriptor();
bis3 = new BufferedInputStream(new FileInputStream(fileDescriptor1));
byte[] bytes = new byte[bis3.available()];
boolean write3 = renderer1.write(bytes, 0, bytes.length);
} catch (IOException e) {
e.printStackTrace();
}finally {
if (bis3!=null){
try {
bis3.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}

BufferedInputStream bis4 = null;
try {
RawFileDescriptor rawFileDescriptor = getResourceManager().getRawFileEntry(Path1).openRawFileDescriptor();
FileDescriptor fileDescriptor1 = rawFileDescriptor.getFileDescriptor();
bis4 = new BufferedInputStream(new FileInputStream(fileDescriptor1));
short[] shorts = new short[bis4.available()];
boolean write4 = renderer1.write(shorts, 0, shorts.length);
} catch (IOException e) {
e.printStackTrace();
}finally {
if (bis4!=null){
try {
bis4.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}

（可选）当需要对音频播放进行暂停或停止时，调用AudioRenderer实例化对象的pause()或stop()方法进行暂停或停止播放。

AudioRenderer renderer = new AudioRenderer(audioRendererInfo, AudioRenderer.PlayMode.MODE_STREAM);
renderer.pause();

1. （可选）调用AudioRenderer实例化对象的setSpeed调节播放速度，setVolume调节播放音量。

   renderer.setSpeed(0.5f);renderer.setVolume(0.5f);renderer.stop();

2. 任务结束后，调用AudioRenderer实例化对象的release()释放资源。
   renderer.release();