From 46a14309140295351fbc66913ab74084d5254cec Mon Sep 17 00:00:00 2001 From: Wang Chongteng Date: Sat, 29 Mar 2025 10:26:03 +0800 Subject: [PATCH 1/3] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=93=8D=E5=BA=A6?= =?UTF-8?q?=E8=B0=83=E8=8A=82=E6=8E=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Wang Chongteng --- .../audio_renderer/native_audiorenderer.h | 42 +++++++++++++++++++ 1 file changed, 42 insertions(+) diff --git a/multimedia/audio_framework/audio_renderer/native_audiorenderer.h b/multimedia/audio_framework/audio_renderer/native_audiorenderer.h index be7722f07ad..2390c86585f 100644 --- a/multimedia/audio_framework/audio_renderer/native_audiorenderer.h +++ b/multimedia/audio_framework/audio_renderer/native_audiorenderer.h @@ -564,6 +564,48 @@ typedef void (*OH_AudioRenderer_OnInterruptCallback)(OH_AudioRenderer* renderer, typedef void (*OH_AudioRenderer_OnErrorCallback)(OH_AudioRenderer* renderer, void* userData, OH_AudioStream_Result error); +/** + * @brief Sets the loudness gain of current renderer. + * The stream usage of the audio renderer must be {@link OH_AudioStream_Usage#AUDIOSTREAM_USAGE_MUSIC}, + * {@link OH_AudioStream_Usage#AUDIOSTREAM_USAGE_MOVIE} or + * {@link OH_AudioStream_Usage#AUDIOSTREAM_USAGE_AUDIOBOOK}. + * The latency mode of the audio renderer must be + * {@link OH_AudioStream_LatencyMode#AUDIOSTREAM_LATENCY_MODE_NORMAL}. + * + * @since 19 + * + * @param renderer Reference created by OH_AudioStreamBuilder_GenerateRenderer() + * @param loudnessGain loudness gain to set which changes from -90.0 to 24.0. It is expressed in dB. + * @return Function result code: + * {@link AUDIOSTREAM_SUCCESS} If the execution is successful. + * {@link AUDIOSTREAM_ERROR_INVALID_PARAM}: + * 1.The param of renderer is nullptr; + * 2.The param of loudnessGain is invalid. + * {@link AUDIOSTREAM_ERROR_ILLEGAL_STATE} This audio renderer is not supported to set loudness gain. + * {@link AUDIOSTREAM_ERROR_SYSTEM}: + * 1.Crash or blocking occurs in system process. + * 2.Other unexpected error from internal system. + */ +OH_AudioStream_Result OH_AudioRenderer_SetLoudnessGain(OH_AudioRenderer* renderer, float loudnessGain); + +/** + * Get the loudness gain of current renderer. + * + * @since 12 + * + * @param renderer Reference created by OH_AudioStreamBuilder_GenerateRenderer() + * @param loudnessGain Pointer to a variable to receive the loudness gain. + * @return Function result code: + * {@link AUDIOSTREAM_SUCCESS} If the execution is successful. + * {@link AUDIOSTREAM_ERROR_INVALID_PARAM}: + * 1.The param of renderer is nullptr; + * 2.The param of loudnessGain is nullptr. + * {@link AUDIOSTREAM_ERROR_SYSTEM}: + * 1.Crash or blocking occurs in system process. + * 2.Other unexpected error from internal system. + */ +OH_AudioStream_Result OH_AudioRenderer_GetLoudnessGain(OH_AudioRenderer* renderer, float* loudnessGain); + #ifdef __cplusplus } #endif -- Gitee From 17b8b8b2763f85522c24e80d0a7efa9d6a813999 Mon Sep 17 00:00:00 2001 From: Wang Chongteng Date: Sat, 29 Mar 2025 11:16:30 +0800 Subject: [PATCH 2/3] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=93=8D=E5=BA=A6?= =?UTF-8?q?=E8=B0=83=E6=95=B4=E6=8E=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Wang Chongteng --- .../audio_framework/audio_renderer/native_audiorenderer.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/multimedia/audio_framework/audio_renderer/native_audiorenderer.h b/multimedia/audio_framework/audio_renderer/native_audiorenderer.h index 2390c86585f..5436a7cc90e 100644 --- a/multimedia/audio_framework/audio_renderer/native_audiorenderer.h +++ b/multimedia/audio_framework/audio_renderer/native_audiorenderer.h @@ -572,7 +572,7 @@ typedef void (*OH_AudioRenderer_OnErrorCallback)(OH_AudioRenderer* renderer, voi * The latency mode of the audio renderer must be * {@link OH_AudioStream_LatencyMode#AUDIOSTREAM_LATENCY_MODE_NORMAL}. * - * @since 19 + * @since 20 * * @param renderer Reference created by OH_AudioStreamBuilder_GenerateRenderer() * @param loudnessGain loudness gain to set which changes from -90.0 to 24.0. It is expressed in dB. @@ -591,7 +591,7 @@ OH_AudioStream_Result OH_AudioRenderer_SetLoudnessGain(OH_AudioRenderer* rendere /** * Get the loudness gain of current renderer. * - * @since 12 + * @since 20 * * @param renderer Reference created by OH_AudioStreamBuilder_GenerateRenderer() * @param loudnessGain Pointer to a variable to receive the loudness gain. -- Gitee From 40b89fc72d60f53d42760cf5464ce0a50ef4b3a2 Mon Sep 17 00:00:00 2001 From: Wang Chongteng Date: Sat, 29 Mar 2025 11:38:22 +0800 Subject: [PATCH 3/3] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E5=93=8D=E5=BA=A6?= =?UTF-8?q?=E8=B0=83=E6=95=B4=E6=8E=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Wang Chongteng --- .../audio_framework/audio_renderer/native_audiorenderer.h | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/multimedia/audio_framework/audio_renderer/native_audiorenderer.h b/multimedia/audio_framework/audio_renderer/native_audiorenderer.h index 5436a7cc90e..a38e2b9d4eb 100644 --- a/multimedia/audio_framework/audio_renderer/native_audiorenderer.h +++ b/multimedia/audio_framework/audio_renderer/native_audiorenderer.h @@ -565,7 +565,7 @@ typedef void (*OH_AudioRenderer_OnErrorCallback)(OH_AudioRenderer* renderer, voi OH_AudioStream_Result error); /** - * @brief Sets the loudness gain of current renderer. + * @brief Sets the loudness gain of current renderer. The default loudness gain is 0.0dB. * The stream usage of the audio renderer must be {@link OH_AudioStream_Usage#AUDIOSTREAM_USAGE_MUSIC}, * {@link OH_AudioStream_Usage#AUDIOSTREAM_USAGE_MOVIE} or * {@link OH_AudioStream_Usage#AUDIOSTREAM_USAGE_AUDIOBOOK}. -- Gitee