鸿蒙5.0&next开发【@ohos.multimedia.avVolumePanel (音量面板)】音频服务-CSDN博客

本文链接：https://blog.csdn.net/m0_70748845/article/details/146610372

本模块提供创建音量面板AVVolumePanel的功能，提供展示和调节系统音量的统一面板。

应用无法直接调节系统音量，可以通过系统音量面板，让用户通过界面操作来调节音量。当用户通过应用内音量面板调节音量时，系统会展示音量提示界面，显性地提示用户系统音量发生改变。

说明

本模块首批接口从API version 12开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
示例效果请以真机为准，当前DevEco Studio预览器无真实音量展示和调节功能。
设备限制： 当前功能不支持在2in1设备上使用。

导入模块

import { AVVolumePanel } from '@kit.AudioKit';

属性

支持[通用属性]

AVVolumePanel

AVVolumePanel({volumeLevel?: number, volumeParameter?: AVVolumePanelParameter})

音量面板，可用于在当前应用内展示音量调节面板。

装饰器类型： [@Component]

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

名称	类型	必填	装饰器类型	说明
volumeLevel	number	否	@Prop	通过音量面板设置设备音量。该值应介于当前设备音量的最小值和最大值之间。如果该值大于当前设备音量的最大值，则视为设置设备最大音量值；如果该值小于当前设备音量的最小值，则视为设置设备最小音量值。获取音量的最大值与最小值可参考[AudioVolumeGroupManager]。
volumeParameter	[AVVolumePanelParameter]	否	@Prop	设置音量面板的自定义参数。如果不传入该参数，则调用系统音量条。

AVVolumePanelParameter

音量面板参数设置。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

名称	类型	必填	说明
position	[Position]	否	设置音量面板的位置。

事件

支持[通用事件]

使用建议

应用在实现自定义音量条的过程中，建议使用音频框架的音量变化监听接口，通过接口回调的音量类型volumeEvent.volumeType，音量等级volumeEvent.volume以及是否显示音量条volumeEvent.updateUi等信息，应用可以判断是否需要处理当前数据和显示自定义的音量条。
为确保用户能感知音量变化，不允许应用后台调节音量，系统会做出对应的控制措施。

示例

音量面板功能的示例说明参考如下。

import { AVVolumePanel } from '@kit.AudioKit';

@Entry
@Component
struct Index {

  @State volume: number = 0;

  build() {
    Row() {
      Column() {
        AVVolumePanel({
          volumeLevel: this.volume,
          volumeParameter: {
            position: {
              x: 100,
              y: 200
            }
          }
        })
      }
    }.width('50%').height('50%')
  }
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述