Skip to content

音频Audio

该组件基于 vue3-audio-player 封装,用于在低代码平台中嵌入可自定义样式的音频播放器,支持绑定动态音频源、封面及标题,并暴露播放器实例以供高级控制。

基础属性

属性名类型默认值说明
progressBarColorstring--进度条颜色
indicatorColorstring--指示器颜色
autoPlayboolean--是否自动播放

高级属性

属性名类型默认值说明
srcstring--音频地址(可绑定)
titlestring--音频标题(可绑定)
coverImagestring--封面图片地址(可绑定)

上下文

该组件通过 exposeContext 暴露运行时上下文,使用方式如下:

  • 可执行函数(如事件函数、属性绑定函数)中,通过 $useExposeContext(key) 获取;
  • 自定义 Hook 或其他组件中,通过 useExposeContext(key) 获取。
typescript
exposeContext({
  audioRef: () => audioRef.value
})

上下文内容:

键(key)说明
audioRef返回vue3-audio-player 组件的实例引用,可用于调用其内部方法(如 play、pause 等)