播放音量管理

2024-02-16 13:54 更新

播放音量的管理主要包括对系统音量的管理和对音频流音量的管理。系统音量与音频流音量分别是指HarmonyOS系统的总音量和指定音频流的音量,其中音频流音量的大小受制于系统音量,管理两者的接口不同。

详细的API说明请参考audio API参考

系统音量

管理系统音量的接口是AudioVolumeManager,在使用之前,需要使用getVolumeManager()获取AudioVolumeManager实例。目前该接口只能获取音量信息及监听音量变化,不能主动调节系统音量。

  1. import audio from '@ohos.multimedia.audio';
  2. let audioManager = audio.getAudioManager();
  3. let audioVolumeManager = audioManager.getVolumeManager();

监听系统音量变化

通过设置监听事件,可以监听系统音量的变化:

  1. audioVolumeManager.on('volumeChange', (volumeEvent) => {
  2. console.info(`VolumeType of stream: ${volumeEvent.volumeType} `);
  3. console.info(`Volume level: ${volumeEvent.volume} `);
  4. console.info(`Whether to updateUI: ${volumeEvent.updateUi} `);
  5. });

音频流音量

管理音频流音量的接口是AVPlayer或AudioRenderer的setVolume()方法,使用AVPlayer设置音频流音量的示例代码如下:

  1. let volume = 1.0 // 指定的音量大小,取值范围为[0.00-1.00],1表示最大音量
  2. avPlayer.setVolume(volume)

使用AudioRenderer设置音频流音量的示例代码如下:

  1. audioRenderer.setVolume(0.5).then(data=>{ // 音量范围为[0.0-1.0]
  2. console.info('Invoke setVolume succeeded.');
  3. }).catch((err) => {
  4. console.error(`Invoke setVolume failed, code is ${err.code}, message is ${err.message}`);
  5. });
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号