# 低功耗音频播放

从API version 11开始支持低功耗音频播放。

低功耗音频播放是一种通过软硬件协同设计实现的音频渲染方案。其核心机制是增大音频渲染器的内部缓冲区，使系统能够一次性填充大量音频数据，从而允许主处理器长时间休眠，减少频繁处理音频数据的功耗，显著降低系统级功耗负载。

#### 使用前提

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

#### 开发指导

低功耗音频渲染器与普通音频渲染器接口无差异，但需关注应用数据周期与播放进度。音频渲染器使用请参考使用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个周期内时间戳不变，即为播完；或者根据设置的倍速推算剩余播放时长，超过相应时长，即为播完。（如：记总写入数据量p1，写完后获取时间戳p2，设置倍速α且α>0，音频采样率fs且fs\>0，剩余可播时长t。公式：）