From db2c01b40f973200fb06708bf6b9b0885c495603 Mon Sep 17 00:00:00 2001 From: magekkkk Date: Thu, 17 Apr 2025 06:07:05 +0000 Subject: [PATCH] add perf doc Signed-off-by: magekkkk --- .../common/native_audiostreambuilder.h | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/multimedia/audio_framework/common/native_audiostreambuilder.h b/multimedia/audio_framework/common/native_audiostreambuilder.h index 5fb946d81..799d066cd 100644 --- a/multimedia/audio_framework/common/native_audiostreambuilder.h +++ b/multimedia/audio_framework/common/native_audiostreambuilder.h @@ -272,6 +272,22 @@ OH_AudioStream_Result OH_AudioStreamBuilder_SetCapturerCallback(OH_AudioStreamBu /** * Create the audio renderer client. * + * The AudioRenderer instance is used to play streaming audio data. + * When using AudioRenderer apis, there are many instructions for application + * to achieve better performance and lower power consumption: + * In music or audiobook background playback situation, you can have low power + * consumption by following this best practices document [Low-Power Rules in Music Playback Scenarios]{@link + * https://developer.huawei.com/consumer/en/doc/best-practices/bpta-music-playback-scenarios}. + * And for navigation situation, you can follow [Low-Power Rules in Navigation and Positioning Scenarios]{@link + * https://developer.huawei.com/consumer/en/doc/best-practices/bpta-navigation-scenarios}. + * + * Application developer should also be careful when app goes to background, please check if your audio playback + * is still needed, see [Audio Resources]{@link + * https://developer.huawei.com/consumer/en/doc/best-practices/bpta-reasonable-audio-use}. + * And avoiding to send silence audio data continuously to waste system resources, otherwise system will take + * control measures when this behavior is detected, see [Audio Playback]{@link + * https://developer.huawei.com/consumer/en/doc/best-practices/bpta-reasonable-audio-playback-use}. + * * @since 10 * * @param builder Reference provided by OH_AudioStreamBuilder_Create() -- Gitee