video
更新时间：2024-11-28 20:27:11
video
视频
属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| src | string | 要播放视频的资源地址，支持网络路径、本地临时路径、云文件ID | ||
| duration | number | 指定视频时长 | ||
| controls | boolean | true | 是否显示默认播放控件（播放/暂停按钮、播放进度、时间） | |
| danmu-list | array | 弹幕列表 | ||
| danmu-btn | boolean | false | 是否显示弹幕按钮，只在初始化时有效，不能动态变更 | |
| enable-danmu | boolean | false | 是否展示弹幕，只在初始化时有效，不能动态变更 | |
| autoplay | boolean | false | 是否自动播放 | |
| loop | boolean | false | 是否循环播放 | |
| muted | boolean | false | 是否静音播放 | |
| show-mute-btn | boolean | false | 是否展示静音按钮 | |
| initial-time | number | 0 | 指定视频初始播放位置 | |
| show-progress | boolean | true | 若不设置，宽度大于240时才会显示 | |
| show-fullscreen-btn | boolean | true | 是否显示全屏按钮 | |
| show-play-btn | boolean | true | 是否显示视频底部控制栏的播放按钮 | |
| show-center-play-btn | boolean | true | 是否显示视频中间的播放按钮 | |
| object-fit | string | contain | 当视频大小与 video 容器大小不一致时，视频的表现形式 | |
| poster | string | 当前标题 | 视频封面的图片网络资源地址或云文件ID | |
| bindplay | eventhandle | 当开始/继续播放时触发play事件 | ||
| bindpause | eventhandle | 当暂停播放时触发 pause 事件 | ||
| bindended | eventhandle | 当播放到末尾时触发 ended 事件 | ||
| bindtimeupdate | eventhandle | 播放进度变化时触发，event.detail = {currentTime, duration} 。触发频率 250ms 一次 | ||
| bindfullscreenchange | eventhandle | 视频进入和退出全屏时触发，event.detail = {fullScreen, direction}，direction 有效值为 vertical 或 horizontal | ||
| bindwaiting | eventhandle | 视频出现缓冲时触发 | ||
| binderror | eventhandle | 视频播放出错时触发 | ||
| bindprogress | eventhandle | 加载进度变化时触发，只支持一段加载。event.detail = {buffered}，百分比 | ||
| bindloadedmetadata | eventhandle | 视频元数据加载完成时触发。event.detail = {width, height, duration} |
object-fit 的合法值
值 | 说明 |
|---|---|
| contain | 包含 |
| fill | 填充 |
| cover | 覆盖 |
video 支持的播放格式
未来 video 会接入同层组件，与 web 版本支持格式无法完全对齐，所以这里推荐使用可以对齐的格式
格式 | IOS | Android |
|---|---|---|
| mp4（推荐） | √ | √ |
| mov （推荐） | √ | √ |
| m4v | √ | √ |
| 3gp | X | X |
| avi | X | X |
| m3u8 （推荐） | √ | √ |
| webm | X | √ |
扫码预览
组件示例
该文档是否对您有帮助？