开发指导

** 【写作要求】**

必选。 描述各个场景下，开发者如何完成开发任务。 可根据多场景任务增加章节。写作要求见下，完成写作后，请逐项自检。

场景介绍

** 【写作要求】**

必选。 *描述在什么情景下解决什么问题，最终达到什么样的效果。*应用SCQA描述方法：

• S：situation（情景），由大家都熟悉的的情景，事实引入。

• C：complication（冲突），但是实际情况往往和我们的要求有冲突。

• Q：question（疑问），怎么办？

• A：answer（回答），我们的解决方案是 …

写作要求见下，完成写作后，请逐项自检。

【写作样例】

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

接口说明

** 【写作要求】**

必选。 描述本开发指导相关的接口有哪些，旨在要开发者在开发前有大体了解，提升开发效率。 写作要求见下，完成写作后，请逐项自检。

【写作样例】

音频播放开放能力如下：AudioRenderer类，具体的API详见接口文档。

表1 音频播放API接口功能介绍

开发步骤

** 【写作要求】**

• 必选。描述* 开发的整体过程，便于开发者快速完成开发。 * 具体 写作要求见下，完成写作后，请逐项自检下。*

【写作样例】

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();
   

2. 使用步骤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();
   

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

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

调测验证（可选）

** 【写作要求】**

可选。 描述开发完成后，进行调测验证，确保最终操作成功。 操作步骤要求同“开发指导”，其他具体写作要求见下，完成写作后，请逐项自检下。