From 97faa2dd6465fc0b5346d06bdaa4426391d1f7b2 Mon Sep 17 00:00:00 2001 From: zhangwt3652 Date: Thu, 3 Jul 2025 11:41:17 +0800 Subject: [PATCH] add mute interrupt description Signed-off-by: zhangwt3652 --- .../audio/using-audiocapturer-for-recording.md | 16 ++++++++++++++++ .../media/audio/using-ohaudio-for-recording.md | 10 ++++++++++ .../reference/apis-audio-kit/js-apis-audio.md | 4 ++-- 3 files changed, 28 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/media/audio/using-audiocapturer-for-recording.md b/zh-cn/application-dev/media/audio/using-audiocapturer-for-recording.md index 29d42bf1ce3..36721dba756 100644 --- a/zh-cn/application-dev/media/audio/using-audiocapturer-for-recording.md +++ b/zh-cn/application-dev/media/audio/using-audiocapturer-for-recording.md @@ -249,3 +249,19 @@ function release() { } } ``` + +### 设置静音打断模式 +开发者可以在创建AudioCapturer实例时，调用[setWillMuteWhenInterrupted](../../reference/apis-audio-kit/js-apis-audio.md#setwillmutewheninterrupted20)设置是否开启静音打断模式。默认不开启，此时根据音频焦点策略管理并发音频流的执行。开启后，在即将被其他应用打断导致停止或暂停录制时会进入静音录制状态，在此状态下录制的音频没有声音。 + +开发示例 + +```ts +import { BusinessError } from '@kit.BasicServicesKit'; + +// 开启静音打断模式。 +audioCapturer.setWillMuteWhenInterrupted(true).then(() => { + console.info('setWillMuteWhenInterrupted Success!'); +}).catch((err: BusinessError) => { + console.error(`setWillMuteWhenInterrupted Fail: ${err}`); +}); +``` \ No newline at end of file diff --git a/zh-cn/application-dev/media/audio/using-ohaudio-for-recording.md b/zh-cn/application-dev/media/audio/using-ohaudio-for-recording.md index e0aa6bfeacb..c190ef9a64b 100644 --- a/zh-cn/application-dev/media/audio/using-ohaudio-for-recording.md +++ b/zh-cn/application-dev/media/audio/using-ohaudio-for-recording.md @@ -243,6 +243,16 @@ OH_AudioStream_LatencyMode latencyMode = AUDIOSTREAM_LATENCY_MODE_FAST; OH_AudioStreamBuilder_SetLatencyMode(builder, latencyMode); ``` +## 设置静音打断模式 +开发者可以在创建音频录制构造器时，调用[OH_AudioStream_Result OH_AudioStreamBuilder_SetCapturerWillMuteWhenInterrupted](../../reference/apis-audio-kit/capi-native-audiostreambuilder-h.md#oh_audiostreambuilder_setcapturerwillmutewheninterrupted)设置是否开启静音打断模式。默认不开启，此时根据音频焦点策略管理并发音频流的执行。开启后，在即将被其他应用打断导致停止或暂停录制时会进入静音录制状态，在此状态下录制的音频没有声音。 + +开发示例 + +```cpp +// 开启静音打断模式。 +OH_AudioStream_Result OH_AudioStreamBuilder_SetCapturerWillMuteWhenInterrupted(builder, true); +``` + ## 相关实例 针对OHAudio开发音频录制，有以下相关实例可供参考： diff --git a/zh-cn/application-dev/reference/apis-audio-kit/js-apis-audio.md b/zh-cn/application-dev/reference/apis-audio-kit/js-apis-audio.md index 2e225529c8d..04178162dad 100644 --- a/zh-cn/application-dev/reference/apis-audio-kit/js-apis-audio.md +++ b/zh-cn/application-dev/reference/apis-audio-kit/js-apis-audio.md @@ -10202,7 +10202,7 @@ try { setWillMuteWhenInterrupted(muteWhenInterrupted: boolean): Promise<void> -设置当前录制音频流是否启用静音打断模式。使用Promise异步回调。 +设置当前录制音频流是否启用[静音打断模式](../../media/audio/using-audiocapturer-for-recording.md#设置静音打断模式)。使用Promise异步回调。 **系统能力：** SystemCapability.Multimedia.Audio.Capturer @@ -10231,7 +10231,7 @@ setWillMuteWhenInterrupted(muteWhenInterrupted: boolean): Promise<void> ```ts import { BusinessError } from '@kit.BasicServicesKit'; -audioRenderer.setWillMuteWhenInterrupted(true).then(() => { +audioCapturer.setWillMuteWhenInterrupted(true).then(() => { console.info('setWillMuteWhenInterrupted Success!'); }).catch((err: BusinessError) => { console.error(`setWillMuteWhenInterrupted Fail: ${err}`); -- Gitee