输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
指南
指南媒体Audio Kit（音频服务）音频录制管理麦克风静音状态

管理麦克风静音状态

更新时间: 2026-08-29 09:41
本文导读

因为在录制过程中需要使用麦克风录制相关音频数据，所以建议开发者在调用录制接口前查询麦克风状态，并在录制过程中监听麦克风的状态变化，避免影响录制效果。

在音频录制过程中，用户可以将麦克风静音，此时录音过程正常进行，录制生成的数据文件的大小随录制时长递增，但写入文件的数据均为0，即无声数据（空白数据）。

录音不支持音量调节。

开发步骤及注意事项

以下各步骤示例为片段代码，可通过示例代码右下方链接获取完整示例。

在AudioVolumeGroupManager中提供了管理麦克风状态的方法，接口的详细说明请参考音量API文档AudioVolumeGroupManager。

  1. 创建audioVolumeGroupManager对象。

    收起
    自动换行
    深色代码主题
    复制
    1. import { audio } from '@kit.AudioKit';
    2. 

    3. let audioVolumeGroupManager: audio.AudioVolumeGroupManager;
    4. // 创建audioVolumeGroupManager对象。
    5. async function loadVolumeGroupManager(updateCallback?: (msg: string, isError: boolean) => void): Promise<void> {
    6.   const groupid = audio.DEFAULT_VOLUME_GROUP_ID;
    7.   audioVolumeGroupManager = await audio.getAudioManager().getVolumeManager().getVolumeGroupManager(groupid);
    8.   console.info('audioVolumeGroupManager create success.');
    9.   // ...
    10. }
    MacManager.ets

  2. 调用on('micStateChange')监听麦克风状态变化，当麦克风静音状态发生变化时将通知应用。

    目前此订阅接口在单进程多AudioManager实例的使用场景下，仅最后一个实例的订阅生效，其他实例的订阅会被覆盖（即使最后一个实例未订阅），因此推荐使用单一AudioManager实例进行开发。

    收起
    自动换行
    深色代码主题
    复制
    1. // 监听麦克风状态变化。
    2. async function on() {
    3.   audioVolumeGroupManager.on('micStateChange', (micStateChange: audio.MicStateChangeEvent) => {
    4.     console.info(`Current microphone status is: ${micStateChange.mute} `);
    5.   });
    6. }
    MacManager.ets

  3. 调用isMicrophoneMute查询麦克风当前静音状态，返回true为静音，false为非静音。

    收起
    自动换行
    深色代码主题
    复制
    1. // 查询麦克风是否静音。
    2. async function isMicrophoneMute(updateCallback?: (msg: string, isError: boolean) => void): Promise<void> {
    3.   await audioVolumeGroupManager.isMicrophoneMute().then((value: boolean) => {
    4.     console.info(`isMicrophoneMute is: ${value}.`);
    5.     // ...
    6.   });
    7. }
    MacManager.ets
实现录制系统音频
查询和监听其他应用录制状态
相关推荐
文档如何判断麦克风正在录音
文档查询和监听其他应用录制状态
文档设置麦克风状态
文档音频播放流管理
文档录音无声定位指导
文档录音的时候播放音乐，如何自动中断录音
文档如何实现录音监听
文档使用AVRecorder录制音频（ArkTS）
文档管理音频输入设备开发实践
文档如何在录制采集音频时获取麦克风的音量大小
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 指南 中进行搜索
请输入您想要搜索的关键词