鸿蒙OS 音频播放开发指导

场景介绍

音频播放的主要工作是将音频数据转码为可听见的音频模拟信号并通过输出设备进行播放，同时对播放任务进行管理。

接口说明

开发步骤

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

   AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().sampleRate(
       AudioStreamInfo.SAMPLE_RATE_UNSPECIFIED)
       .audioStreamFlag(AudioStreamInfo.AudioStreamFlag.AUDIO_STREAM_FLAG_NONE)
       .encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_INVALID)
       .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_INVALID)
       .streamUsage(AudioStreamInfo.StreamUsage.STREAM_USAGE_UNKNOWN)
       .build();

以真实的播放pcm流为例：

   AudioStreamInfo audioStreamInfo = new AudioStreamInfo.Builder().sampleRate(44100) // 44.1kHz
       .audioStreamFlag(AudioStreamInfo.AudioStreamFlag.AUDIO_STREAM_FLAG_MAY_DUCK) // 混音
       .encodingFormat(AudioStreamInfo.EncodingFormat.ENCODING_PCM_16BIT) // 16-bit PCM
       .channelMask(AudioStreamInfo.ChannelMask.CHANNEL_OUT_STEREO) // 双声道
       .streamUsage(AudioStreamInfo.StreamUsage.STREAM_USAGE_MEDIA) // 媒体类音频
       .build();

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

   AudioRendererInfo audioRendererInfo = new AudioRendererInfo.Builder().audioStreamInfo(audioStreamInfo)
       .audioStreamOutputFlag(AudioRendererInfo.AudioStreamOutputFlag.AUDIO_STREAM_OUTPUT_FLAG_NONE)
       .bufferSizeInBytes(0)
       .distributedDeviceId("")
       .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)
       .distributedDeviceId("E54***5E8") // 使用分布式设备E54***5E8播放
       .isOffload(false) // false表示分段传输buffer并播放，true表示整个音频流一次性传输到HAL层播放
       .build();

1. 根据要播放音频流指定 PlayMode，不同的 PlayMode 在写数据时存在差异，详情见[步骤7]，其余播放流程是无区别的。并通过构造函数获取 AudioRenderer 类的实例化对象。

1. 使用构造函数获取 AudioRenderer 类的实例化对象，其中[步骤2]，[步骤3]中的数据为构造函数的必选参数，指定播放设备为可选参数，根据使用场景选择不同的构造函数。

1. （可选）构造音频播放回调，首先构造对象 AudioInterrupt，其中 setInterruptListener 方法的入参需要实现接口类 InterruptListener， setStreamInfo 方法使用[步骤1]的 AudioStreamInfo 作为入参。然后调用 AudioManager 类的 activateAudioInterrupt(AudioInterrupt interrupt)方法进行音频播放回调注册。代码示例如下：

   AudioInterrupt audioInterrupt = new AudioInterrupt();
   AudioManager audioManager = new AudioManager();
   audioInterrupt.setStreamInfo(streamInfo);
   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.play();
           } else {
           }
       }
   });
   audioManager.activateAudioInterrupt(audioInterrupt);

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

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

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

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

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