能力

audio

音频播放组件，配合 ac.playMedia 等媒体 API 控制。

协议优先微信兼容子集宿主能力：media

使用示例

<audio id="voice" src="{{audioSrc}}" controls />

属性说明

属性	类型	默认值	必填	说明
`id`	`string`		否	节点标识，可用于 label.for 或测试定位。
`class`	`string`		否	附加样式类名。
`style`	`string`		否	受限内联样式。
`hidden`	`boolean`	false	否	是否隐藏当前节点。
`data-*`	`string`		否	事件触发时进入 event.dataset。
`id`	`string`		否	节点标识，可用于 label.for 或测试定位。
`src`	`string`	必填	是	资源地址或包内资源路径。
`controls`	`boolean`	false	否	是否展示媒体控件。
`autoplay`	`boolean`	false	否	是否自动播放。
`loop`	`boolean`	false	否	是否循环播放。
`muted`	`boolean`	false	否	是否静音。

事件说明

事件	event.detail	说明
`bindplay`	`{ currentTime, duration }`	组件状态变化时触发。
`bindpause`	`{ currentTime, duration }`	组件状态变化时触发。
`bindended`	`{ currentTime, duration }`	组件状态变化时触发。
`binderror`	`{ currentTime, duration }`	组件状态变化时触发。
`bindload`	`{ currentTime, duration }`	组件状态变化时触发。

Manifest 声明

能力组件必须声明权限和 API。没有宿主 provider 时，运行时会展示稳定降级态或返回结构化错误。

{
  "permissions": [
    "media"
  ],
  "apisUsed": [
    "ac.getMediaInfo"
  ]
}

平台支持

平台	支持情况
Web	支持
Android SDK	WebView 运行时支持
iOS SDK	WebView 运行时支持
Flutter SDK	WebView 运行时支持

渲染协议

字段	值
HTML 标签	`audio`
样式类	`mini-audio`
是否空元素	否
必填属性	src
必需 API	ac.getMediaInfo