harmony 鸿蒙Interface (AudioVolumeGroupManager)

  • 2025-06-12
  • 浏览 (3)

Interface (AudioVolumeGroupManager)

说明： 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

管理音频组音量。

在使用AudioVolumeGroupManager的接口之前，需先通过getVolumeGroupManager获取AudioVolumeGroupManager实例。

getVolume9+

getVolume(volumeType: AudioVolumeType, callback: AsyncCallback<number>): void

获取指定流的音量。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
callback AsyncCallback<number> 是 回调函数。当获取指定流的音量成功，err为undefined，data为获取到的指定流的音量；否则为错误对象。指定流的音量等级范围可通过getMinVolume和getMaxVolume获取。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.getVolume(audio.AudioVolumeType.MEDIA, (err: BusinessError, value: number) => {
  if (err) {
    console.error(`Failed to obtain the volume. ${err}`);
    return;
  }
  console.info('Callback invoked to indicate that the volume is obtained.');
});

getVolume9+

getVolume(volumeType: AudioVolumeType): Promise<number>

获取指定流的音量。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
Promise<number> Promise对象，返回指定流的音量。指定流的音量等级范围可通过getMinVolume和getMaxVolume获取。

示例：

audioVolumeGroupManager.getVolume(audio.AudioVolumeType.MEDIA).then((value: number) => {
  console.info(`Promise returned to indicate that the volume is obtained ${value}.`);
});

getVolumeSync10+

getVolumeSync(volumeType: AudioVolumeType): number

获取指定流的音量。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
number 返回指定流的音量。指定流的音量等级范围可通过getMinVolume和getMaxVolume获取。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: number = audioVolumeGroupManager.getVolumeSync(audio.AudioVolumeType.MEDIA);
  console.info(`Indicate that the volume is obtained ${value}.`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Failed to obtain the volume, error ${error}.`);
}

getMinVolume9+

getMinVolume(volumeType: AudioVolumeType, callback: AsyncCallback<number>): void

获取指定流的最小音量。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
callback AsyncCallback<number> 是 回调函数。当获取指定流的最小音量成功，err为undefined，data为获取到的指定流的最小音量；否则为错误对象。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.getMinVolume(audio.AudioVolumeType.MEDIA, (err: BusinessError, value: number) => {
  if (err) {
    console.error(`Failed to obtain the minimum volume. ${err}`);
    return;
  }
  console.info(`Callback invoked to indicate that the minimum volume is obtained. ${value}`);
});

getMinVolume9+

getMinVolume(volumeType: AudioVolumeType): Promise<number>

获取指定流的最小音量。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
Promise<number> Promise对象，返回最小音量。

示例：

audioVolumeGroupManager.getMinVolume(audio.AudioVolumeType.MEDIA).then((value: number) => {
  console.info(`Promised returned to indicate that the minimum volume is obtained ${value}.`);
});

getMinVolumeSync10+

getMinVolumeSync(volumeType: AudioVolumeType): number

获取指定流的最小音量。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
number 返回最小音量。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: number = audioVolumeGroupManager.getMinVolumeSync(audio.AudioVolumeType.MEDIA);
  console.info(`Indicate that the minimum volume is obtained ${value}.`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Failed to obtain the minimum volume, error ${error}.`);
}

getMaxVolume9+

getMaxVolume(volumeType: AudioVolumeType, callback: AsyncCallback<number>): void

获取指定流的最大音量。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
callback AsyncCallback<number> 是 回调函数。当获取指定流的最大音量成功，err为undefined，data为获取到的指定流的最大音量；否则为错误对象。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.getMaxVolume(audio.AudioVolumeType.MEDIA, (err: BusinessError, value: number) => {
  if (err) {
    console.error(`Failed to obtain the maximum volume. ${err}`);
    return;
  }
  console.info(`Callback invoked to indicate that the maximum volume is obtained. ${value}`);
});

getMaxVolume9+

getMaxVolume(volumeType: AudioVolumeType): Promise<number>

获取指定流的最大音量。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
Promise<number> Promise对象，返回最大音量大小。

示例：

audioVolumeGroupManager.getMaxVolume(audio.AudioVolumeType.MEDIA).then((data: number) => {
  console.info('Promised returned to indicate that the maximum volume is obtained.');
});

getMaxVolumeSync10+

getMaxVolumeSync(volumeType: AudioVolumeType): number

获取指定流的最大音量。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
number 返回最大音量大小。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: number = audioVolumeGroupManager.getMaxVolumeSync(audio.AudioVolumeType.MEDIA);
  console.info(`Indicate that the maximum volume is obtained. ${value}`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Failed to obtain the maximum volume, error ${error}.`);
}

isMute9+

isMute(volumeType: AudioVolumeType, callback: AsyncCallback<boolean>): void

获取指定音量流静音状态。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
callback AsyncCallback<boolean> 是 回调函数。当获取指定音量流静音状态成功，err为undefined，data为true表示静音，false表示非静音；否则为错误对象。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.isMute(audio.AudioVolumeType.MEDIA, (err: BusinessError, value: boolean) => {
  if (err) {
    console.error(`Failed to obtain the mute status. ${err}`);
    return;
  }
  console.info(`Callback invoked to indicate that the mute status of the stream is obtained ${value}.`);
});

isMute9+

isMute(volumeType: AudioVolumeType): Promise<boolean>

获取指定音量流是否被静音。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
Promise<boolean> Promise对象。返回true表示静音；返回false表示非静音。

示例：

audioVolumeGroupManager.isMute(audio.AudioVolumeType.MEDIA).then((value: boolean) => {
  console.info(`Promise returned to indicate that the mute status of the stream is obtained ${value}.`);
});

isMuteSync10+

isMuteSync(volumeType: AudioVolumeType): boolean

获取指定音量流是否被静音。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。

返回值：

类型 说明
boolean 流静音状态。返回true表示静音，返回false表示非静音。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: boolean = audioVolumeGroupManager.isMuteSync(audio.AudioVolumeType.MEDIA);
  console.info(`Indicate that the mute status of the stream is obtained ${value}.`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Failed to obtain the mute status of the stream, error ${error}.`);
}

getRingerMode9+

getRingerMode(callback: AsyncCallback<AudioRingMode>): void

获取铃声模式。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
callback AsyncCallback<AudioRingMode> 是 回调函数。当获取铃声模式成功，err为undefined，data为获取到的铃声模式；否则为错误对象。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.getRingerMode((err: BusinessError, value: audio.AudioRingMode) => {
  if (err) {
    console.error(`Failed to obtain the ringer mode. ${err}`);
    return;
  }
  console.info(`Callback invoked to indicate that the ringer mode is obtained ${value}.`);
});

getRingerMode9+

getRingerMode(): Promise<AudioRingMode>

获取铃声模式。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

返回值：

类型 说明
Promise<AudioRingMode> Promise对象，返回系统的铃声模式。

示例：

audioVolumeGroupManager.getRingerMode().then((value: audio.AudioRingMode) => {
  console.info(`Promise returned to indicate that the ringer mode is obtained ${value}.`);
});

getRingerModeSync10+

getRingerModeSync(): AudioRingMode

获取铃声模式。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

返回值：

类型 说明
AudioRingMode 返回系统的铃声模式。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: audio.AudioRingMode = audioVolumeGroupManager.getRingerModeSync();
  console.info(`Indicate that the ringer mode is obtained ${value}.`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Failed to obtain the ringer mode, error ${error}.`);
}

on(‘ringerModeChange’)9+

on(type: ‘ringerModeChange’, callback: Callback<AudioRingMode>): void

监听铃声模式变化事件（当铃声模式发生变化时触发）。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
type string 是 事件回调类型，支持的事件为’ringerModeChange’，当铃声模式发生变化时，触发该事件。
callback Callback<AudioRingMode> 是 回调函数，返回变化后的铃音模式。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

audioVolumeGroupManager.on('ringerModeChange', (ringerMode: audio.AudioRingMode) => {
  console.info(`Updated ringermode: ${ringerMode}`);
});

off(‘ringerModeChange’)18+

off(type: ‘ringerModeChange’, callback?: Callback&lt;AudioRingMode&gt;): void

取消监听铃声模式变化事件。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
type string 是 事件回调类型，支持的事件为’ringerModeChange’，当取消监听铃声模式变化事件时，触发该事件。
callback Callback&lt;AudioRingMode&gt; 否 回调函数，返回变化后的铃音模式。

错误码：

以下错误码的详细介绍请参见Audio错误码。

错误码ID 错误信息
6800101 Parameter verification failed.

示例：

// 取消该事件的所有监听。
audioVolumeGroupManager.off('ringerModeChange');

// 同一监听事件中，on方法和off方法传入callback参数一致，off方法取消对应on方法订阅的监听。
let ringerModeChangeCallback = (ringerMode: audio.AudioRingMode) => {
  console.info(`Updated ringermode: ${ringerMode}`);
};

audioVolumeGroupManager.on('ringerModeChange', ringerModeChangeCallback);

audioVolumeGroupManager.off('ringerModeChange', ringerModeChangeCallback);

isMicrophoneMute9+

isMicrophoneMute(callback: AsyncCallback&lt;boolean&gt;): void

获取麦克风静音状态。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
callback AsyncCallback&lt;boolean&gt; 是 回调函数。当获取麦克风静音状态成功，err为undefined，data为true表示静音，false表示非静音；否则为错误对象。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.isMicrophoneMute((err: BusinessError, value: boolean) => {
  if (err) {
    console.error(`Failed to obtain the mute status of the microphone. ${err}`);
    return;
  }
  console.info(`Callback invoked to indicate that the mute status of the microphone is obtained ${value}.`);
});

isMicrophoneMute9+

isMicrophoneMute(): Promise&lt;boolean&gt;

获取麦克风静音状态。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

返回值：

类型 说明
Promise&lt;boolean&gt; Promise对象。返回true表示麦克风被静音；返回false表示麦克风未被静音。

示例：

audioVolumeGroupManager.isMicrophoneMute().then((value: boolean) => {
  console.info(`Promise returned to indicate that the mute status of the microphone is obtained ${value}.`);
});

isMicrophoneMuteSync10+

isMicrophoneMuteSync(): boolean

获取麦克风静音状态。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

返回值：

类型 说明
boolean 系统麦克风静音状态。返回true表示静音，返回false表示非静音。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: boolean = audioVolumeGroupManager.isMicrophoneMuteSync();
  console.info(`Indicate that the mute status of the microphone is obtained ${value}.`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Failed to obtain the mute status of the microphone, error ${error}.`);
}

on(‘micStateChange’)9+

on(type: ‘micStateChange’, callback: Callback&lt;MicStateChangeEvent&gt;): void

监听系统麦克风状态更改事件（当检测到系统麦克风状态发生改变时触发）。使用callback异步回调。

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

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
type string 是 事件回调类型，支持的事件为’micStateChange’，当检测到系统麦克风状态发生改变时，触发该事件。
callback Callback<MicStateChangeEvent> 是 回调函数，返回变更后的麦克风状态。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

audioVolumeGroupManager.on('micStateChange', (micStateChange: audio.MicStateChangeEvent) => {
  console.info(`Current microphone status is: ${micStateChange.mute} `);
});

off(‘micStateChange’)12+

off(type: ‘micStateChange’, callback?: Callback&lt;MicStateChangeEvent&gt;): void

取消监听系统麦克风状态更改事件。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
type string 是 事件回调类型，支持的事件为’micStateChange’，当取消监听系统麦克风状态更改事件时，触发该事件。
callback Callback<MicStateChangeEvent> 否 回调函数，返回变更后的麦克风状态。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters missing; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

// 取消该事件的所有监听。
audioVolumeGroupManager.off('micStateChange');

// 同一监听事件中，on方法和off方法传入callback参数一致，off方法取消对应on方法订阅的监听。
let micStateChangeCallback = (micStateChange: audio.MicStateChangeEvent) => {
  console.info(`Current microphone status is: ${micStateChange.mute} `);
};

audioVolumeGroupManager.on('micStateChange', micStateChangeCallback);

audioVolumeGroupManager.off('micStateChange', micStateChangeCallback);

isVolumeUnadjustable10+

isVolumeUnadjustable(): boolean

获取固定音量模式开关状态，打开时进入固定音量模式，此时音量固定无法被调节。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

返回值：

类型 说明
boolean 固定音量模式开关状态。返回true表示固定音量模式，返回false表示非固定音量模式。

示例：

let volumeAdjustSwitch: boolean = audioVolumeGroupManager.isVolumeUnadjustable();
console.info(`Whether it is volume unadjustable: ${volumeAdjustSwitch}.`);

getSystemVolumeInDb10+

getSystemVolumeInDb(volumeType: AudioVolumeType, volumeLevel: number, device: DeviceType, callback: AsyncCallback&lt;number&gt;): void

获取音量增益dB值。使用callback异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
volumeLevel number 是 音量等级。
device DeviceType 是 设备类型。
callback AsyncCallback&lt;number&gt; 是 回调函数。当获取音量增益dB值成功，err为undefined，data为获取到的音量增益dB值；否则为错误对象。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed. Return by callback.
6800301 System error. Return by callback.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.getSystemVolumeInDb(audio.AudioVolumeType.MEDIA, 3, audio.DeviceType.SPEAKER, (err: BusinessError, dB: number) => {
  if (err) {
    console.error(`Failed to get the volume DB. ${err}`);
  } else {
    console.info(`Success to get the volume DB. ${dB}`);
  }
});

getSystemVolumeInDb10+

getSystemVolumeInDb(volumeType: AudioVolumeType, volumeLevel: number, device: DeviceType): Promise&lt;number&gt;

获取音量增益dB值。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
volumeLevel number 是 音量等级。
device DeviceType 是 设备类型。

返回值：

类型 说明
Promise&lt;number&gt; Promise对象，返回对应的音量增益dB值。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed. Return by promise.
6800301 System error. Return by promise.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.getSystemVolumeInDb(audio.AudioVolumeType.MEDIA, 3, audio.DeviceType.SPEAKER).then((value: number) => {
  console.info(`Success to get the volume DB. ${value}`);
}).catch((error: BusinessError) => {
  console.error(`Fail to adjust the system volume by step. ${error}`);
});

getSystemVolumeInDbSync10+

getSystemVolumeInDbSync(volumeType: AudioVolumeType, volumeLevel: number, device: DeviceType): number

获取音量增益dB值。同步返回结果。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
volumeType AudioVolumeType 是 音量流类型。
volumeLevel number 是 音量等级。
device DeviceType 是 设备类型。

返回值：

类型 说明
number 返回对应的音量增益dB值。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

try {
  let value: number = audioVolumeGroupManager.getSystemVolumeInDbSync(audio.AudioVolumeType.MEDIA, 3, audio.DeviceType.SPEAKER);
  console.info(`Success to get the volume DB. ${value}`);
} catch (err) {
  let error = err as BusinessError;
  console.error(`Fail to adjust the system volume by step. ${error}`);
}

getMaxAmplitudeForInputDevice12+

getMaxAmplitudeForInputDevice(inputDevice: AudioDeviceDescriptor): Promise&lt;number&gt;

获取输入设备音频流的最大电平值，取值范围为[0, 1]。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
inputDevice AudioDeviceDescriptor 是 获取最大电平值的设备信息。

返回值：

类型 说明
Promise&lt;number&gt; Promise对象，返回对应设备的电平值，大小在[0, 1]之间。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed. Return by promise.
6800301 System error. Return by promise.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

let capturerInfo: audio.AudioCapturerInfo = {
  source: audio.SourceType.SOURCE_TYPE_MIC, // 音源类型：Mic音频源。根据业务场景配置，参考SourceType。
  capturerFlags: 0 // 音频采集器标志。
};

audio.getAudioManager().getRoutingManager().getPreferredInputDeviceForCapturerInfo(capturerInfo).then((data) => {
  audioVolumeGroupManager.getMaxAmplitudeForInputDevice(data[0]).then((value) => {
    console.info(`mic volatileume amplitude is: ${value}`);
  }).catch((err: BusinessError) => {
    console.error("getMaxAmplitudeForInputDevice error" + JSON.stringify(err));
  })
}).catch((err: BusinessError) => {
  console.error("get outputDeviceId error" + JSON.stringify(err));
})

getMaxAmplitudeForOutputDevice12+

getMaxAmplitudeForOutputDevice(outputDevice: AudioDeviceDescriptor): Promise&lt;number&gt;

获取输出设备音频流的最大电平值，取值范围为[0, 1]。使用Promise异步回调。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
outputDevice AudioDeviceDescriptor 是 获取最大电平值的设备信息。

返回值：

类型 说明
Promise&lt;number&gt; Promise对象，返回对应设备的电平值，大小在[0, 1]之间。

错误码：

以下错误码的详细介绍请参见通用错误码说明文档和Audio错误码。

错误码ID 错误信息
401 Parameter error. Possible causes: 1.Mandatory parameters are left unspecified; 2.Incorrect parameter types.
6800101 Parameter verification failed. Return by promise.
6800301 System error. Return by promise.

示例：

import { BusinessError } from '@kit.BasicServicesKit';

let rendererInfo: audio.AudioRendererInfo = {
  usage: audio.StreamUsage.STREAM_USAGE_MUSIC, // 音频流使用类型：音乐。根据业务场景配置，参考StreamUsage。
  rendererFlags: 0 // 音频渲染器标志。
};

audio.getAudioManager().getRoutingManager().getPreferOutputDeviceForRendererInfo(rendererInfo).then((data) => {
  audioVolumeGroupManager.getMaxAmplitudeForOutputDevice(data[0]).then((value) => {
    console.info(`mic volatileume amplitude is: ${value}`);
  }).catch((err: BusinessError) => {
    console.error("getMaxAmplitudeForOutputDevice error" + JSON.stringify(err));
  })
}).catch((err: BusinessError) => {
  console.error("getPreferOutputDeviceForRendererInfo error" + JSON.stringify(err));
})

setMicrophoneMute(deprecated)

setMicrophoneMute(mute: boolean, callback: AsyncCallback&lt;void&gt;): void

设置麦克风静音状态。使用callback异步回调。

说明：

从API version 9开始支持，从API version 11开始废弃，替代接口仅面向系统应用开放。

需要权限： ohos.permission.MANAGE_AUDIO_CONFIG，该权限仅系统应用可申请。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
mute boolean 是 是否设置麦克风为静音状态。true表示静音，false表示非静音。
callback AsyncCallback&lt;void&gt; 是 回调函数。当设置麦克风静音状态成功，err为undefined，否则为错误对象。

示例：

import { BusinessError } from '@kit.BasicServicesKit';

audioVolumeGroupManager.setMicrophoneMute(true, (err: BusinessError) => {
  if (err) {
    console.error(`Failed to mute the microphone. ${err}`);
    return;
  }
  console.info('Callback invoked to indicate that the microphone is muted.');
});

setMicrophoneMute(deprecated)

setMicrophoneMute(mute: boolean): Promise&lt;void&gt;

设置麦克风静音状态。使用Promise异步回调。

说明：

从API version 9开始支持，从API version 11开始废弃，替代接口仅面向系统应用开放。

需要权限： ohos.permission.MANAGE_AUDIO_CONFIG，该权限仅系统应用可申请。

系统能力： SystemCapability.Multimedia.Audio.Volume

参数：

参数名 类型 必填 说明
mute boolean 是 是否设置麦克风为静音状态。true表示静音，false表示非静音。

返回值：

类型 说明
Promise&lt;void&gt; Promise对象。无返回结果的Promise对象。

示例：

audioVolumeGroupManager.setMicrophoneMute(true).then(() => {
  console.info('Promise returned to indicate that the microphone is muted.');
});

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Audio Kit（音频服务）

harmony 鸿蒙Interface (AudioCapturer)

harmony 鸿蒙Interface (AudioManager)

harmony 鸿蒙Interface (AudioRenderer)

harmony 鸿蒙Interface (AudioRoutingManager)

harmony 鸿蒙Interface (AudioSessionManager)

harmony 鸿蒙Interface (AudioSpatializationManager)

harmony 鸿蒙Interface (AudioStreamManager)

harmony 鸿蒙Interface (AudioVolumeManager)

harmony 鸿蒙Constants

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/7Rc8ZO
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录