应用/搭建用户界面/小程序端组件/音频
音频
更新于: 2026-06-24 15:44:40
音频组件用于播放音频内容,支持播放本地上传的音频文件,也可绑定工作流返回值或直接填写音频 URL,灵活满足不同音频播放需求。
音频组件支持丰富的属性设置,例如常用设置、位置设置、尺寸设置、样式设置、变换设置、状态设置和可见性设置。
|
属性 |
说明 |
|---|---|
|
音频源 |
配置音频的来源,支持上传本地的音频文件,也可绑定工作流返回值或直接填写音频 URL。 说明 音频支持 mp3、wav、m4a、aac 格式,音频最大不超过 20MB。 |
|
样式 |
选择音频组件的展示样式,支持三种样式:
|
|
是否循环播放 |
设置音频是否在播放结束后自动重新开始播放。开启此功能后,音频将在播放完毕后自动循环播放。 |
|
是否预加载 |
开启预加载功能后,音频文件会在页面加载时提前加载音频,适合对播放延迟有较高要求的场景。 |
|
是否支持下载 |
设置音频文件是否提供下载功能。开启此功能后,用户可以将音频文件保存到本地,方便离线使用或保存音频内容。样式为仅播放按钮,不支持此配置项。 |
|
播控颜色 |
设置音频组件的颜色。 |
音频组件提供三种位置类型选项,以灵活配置组件在界面中的位置。
|
属性 |
说明 |
|---|---|
|
固定比例 |
打开固定比例开关,可以设置图片的比例,例如 |
|
比例 |
配置音频组件的固定比例,支持 |
|
宽度 |
配置音频组件的宽度值,支持以下宽度设置方式:
|
|
高度 |
配置音频组件的高度值,支持以下高度设置方式:
仅关闭了固定比例开关,才支持该参数配置。 |
|
尺寸限制 |
配置音频组件的尺寸限制,支持配置最大高度、最小高度、最大宽度、最小宽度。 |
|
属性 |
说明 |
|---|---|
|
填充 |
配置音频组件背景的显示颜色。 |
|
圆角 |
配置音频组件背景的圆角,支持单独设置四个角的圆角。 |
|
内边距 |
配置音频组件背景的内边距,可以单独设置四个方向的内边距。 |
|
外边距 |
配置音频组件背景的外边距,可以单独设置四个方向的外边距。 |
|
边框 |
配置音频组件背景的边框样式。支持如下设置方式:
|
|
阴影 |
配置音频组件背景的阴影样式,增强组件的立体感。支持如下设置方式:
|
|
图层模糊 |
配置音频组件的模糊效果。数值越大,模糊效果越明显。 |
|
溢出 |
配置音频组件溢出相关设置,支持以下溢出方式:
|
丰富界面视觉效果的参数。
|
属性 |
说明 |
|---|---|
|
缩放 |
配置音频组件大小的缩放比例。 |
|
旋转 |
配置音频组件围绕中心点旋转的角度。 |
|
位移 |
配置音频组件在水平和垂直方向上的移动距离。 |
|
倾斜 |
配置音频组件在水平和垂直方向上的倾斜角度。 |
控制音频组件点击态和出现态的视觉效果参数。
|
属性 |
说明 |
|---|---|
|
点击效果 |
配置音频组件的点击态效果。具体配置说明如下: |
|
出场效果 |
设置音频组件在界面中出现时的动画效果。目前支持设置为淡入、缩放、模糊、水平翻转、垂直翻转、从下滑入、从上滑入、从左滑入、从右滑入等动画效果。 |
控制音频组件隐藏或显示的参数,支持在特定条件下隐藏音频组件。
Input1,当你将音频组件的可见性设置为{{ Input1.value}}后,在单行输入组件中输入文本时,{{ Input1.value}}值为 true,音频组件将被隐藏。通过配置音频组件的事件,可以为音频组件添加丰富的交互功能,例如点击、加载等,以增强用户体验和界面的互动性。
|
事件项 |
说明 |
|---|---|
|
事件类型 |
支持以下事件类型:
|
|
组件方法 |
支持以下方法:
|