1# 播放音量管理 2 3播放音量的管理主要包括对系统音量的管理和对音频流音量的管理。系统音量与音频流音量分别是指OpenHarmony系统的总音量和指定音频流的音量，其中音频流音量的大小受制于系统音量，管理两者的接口不同。 4 5## 系统音量 6 7管理系统音量的接口是AudioVolumeManager，在使用之前，需要使用getVolumeManager()获取AudioVolumeManager实例。目前该接口只能获取音量信息及监听音量变化，不能主动调节系统音量。 8 9```ts 10import audio from '@ohos.multimedia.audio'; 11let audioManager = audio.getAudioManager(); 12let audioVolumeManager = audioManager.getVolumeManager(); 13``` 14 15### 监听系统音量变化 16 17通过设置监听事件，可以监听系统音量的变化： 18 19```ts 20audioVolumeManager.on('volumeChange', (volumeEvent) => { 21 console.info(`VolumeType of stream: ${volumeEvent.volumeType} `); 22 console.info(`Volume level: ${volumeEvent.volume} `); 23 console.info(`Whether to updateUI: ${volumeEvent.updateUi} `); 24}); 25``` 26 27### 调节系统音量（仅对系统应用开放） 28 29目前调节系统音量主要是靠SystemAPI，具体服务于物理音量按键和设置。通过音量按键可以调节系统音量的大小，根据按下的具体按键调用系统接口，实现系统音量的大小调节。调节的音量类型包括媒体、铃声和通知。 30 31## 音频流音量 32 33管理音频流音量的接口是AVPlayer或AudioRenderer的setVolume()方法，使用AVPlayer设置音频流音量的示例代码如下： 34 35```ts 36let volume = 1.0 // 指定的音量大小，取值范围为[0.00-1.00]，1表示最大音量 37avPlayer.setVolume(volume) 38``` 39 40使用AudioRenderer设置音频流音量的示例代码如下： 41 42```ts 43audioRenderer.setVolume(0.5).then(data=>{ // 音量范围为[0.0-1.0] 44 console.info('Invoke setVolume succeeded.'); 45}).catch((err) => { 46 console.error(`Invoke setVolume failed, code is ${err.code}, message is ${err.message}`); 47}); 48``` 49