低功耗音频播放

使用前提

当前支持扬声器、有线耳机和部分蓝牙耳机实现低功耗功能。

开发指导

低功耗音频渲染器与普通音频渲染器接口无差异，但需关注应用数据周期与播放进度。音频渲染器使用请参考使用AudioRenderer开发音频播放功能(ArkTS)和推荐使用OHAudio开发音频播放功能(C/C++)。

数据周期示意图

在数据周期内，快速请求数据写满缓存时，进入休眠状态。当缓存数据消费完后，会触发下一个周期。

播放进度示意图

在数据周期内，快速请求数据写满缓存时，播放进度按实际播放量计算。当缓存数据消费完（即播放进度到达写入数据量）后，会触发下一个周期。

注意事项

1. 流类型使用STREAM_USAGE_MUSIC、STREAM_USAGE_AUDIOBOOK、AUDIOSTREAM_USAGE_MUSIC或AUDIOSTREAM_USAGE_AUDIOBOOK，系统默认为低功耗渲染器。

2. 低功耗渲染器缓冲区：亮屏场景下，最大1000ms；熄屏场景下，最大10000ms。缓冲区数据消费完时会唤醒主处理器，触发应用传送数据，传送数据的周期与缓冲区大小保持一致。

   • 应用在数据周期内未请求数据属于正常现象，无需停流。系统会自行判断长时间未收到数据的情况并停流；当应用重新发送数据时，系统将恢复流状态。
   • 熄屏场景下，数据写满缓存后主处理器进入休眠，应用会进入挂起状态。若应用需要后台播放或熄屏播放，请参考后台播放开发须知。
   • 低功耗渲染器建议应用一次性填满缓冲区，以减少唤醒次数。若应用无法快速提供数据，会降级为普通渲染器。如果普通渲染器无法保证数据及时性，需应用优化数据处理。
   • 当应用数据不足一次回调长度时，不允许填空数据以避免播放卡顿（到达EOS时除外）。建议等待数据充足或返回错误码。具体参考AudioRenderer音频数据回调和OHAudio音频数据回调。

3. 低功耗渲染器和低时延渲染器不支持并发，采用先到先得原则，即先启动的生效，后启动的降级为普通渲染器。具体示例如下：

   • 先启低功耗渲染器A，再启低功耗渲染器B，则B降级普通渲染器。
   • 先启低功耗渲染器，再启低时延渲染器，则低时延降级普通渲染器。
   • 先启低时延渲染器，再启低功耗渲染器，则低功耗降级普通渲染器。

4. 应用数据写完不代表已经播完，需调用获取音频时间戳接口getAudioTimestampInfo或OH_AudioRenderer_GetAudioTimestampInfo()，判断实际播放进度。

   • 获取时间戳接口调用频率建议大于200ms一次，以免影响系统性能。
   • 应用程序调用接口flush或OH_AudioRenderer_Flush()后，播放的数据量会重置为0。
   • 播放数据量均会小于写入数据量。由于系统帧长与时延机制，已播放的数据量不等于写入数据量。
   • 写完数据后获取时间戳，如果2个周期内时间戳不变，即为播完；或者根据设置的倍速推算剩余播放时长，超过相应时长，即为播完。（如：记总写入数据量p₁，写完后获取时间戳p₂，设置倍速α且α>0，音频采样率f_s且f_s>0，剩余可播时长t。公式：）