能力

video

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

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

使用示例

<video id="intro" src="{{videoSrc}}" controls bindplay="onPlay" />

属性说明

属性类型默认值必填说明
idstring否节点标识，可用于 label.for 或测试定位。
classstring否附加样式类名。
stylestring否受限内联样式。
hiddenbooleanfalse否是否隐藏当前节点。
data-*string否事件触发时进入 event.dataset。
idstring否节点标识，可用于 label.for 或测试定位。
srcstring必填是资源地址或包内资源路径。
controlsbooleanfalse否是否展示媒体控件。
autoplaybooleanfalse否是否自动播放。
loopbooleanfalse否是否循环播放。
mutedbooleanfalse否是否静音。
posterstring否视频封面。

事件说明

事件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 SDKWebView 运行时支持
iOS SDKWebView 运行时支持
Flutter SDKWebView 运行时支持

渲染协议

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