video

说明:

  • 从API version 4开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

视频播放组件。

子组件

不支持。

属性

除支持通用属性外,还支持如下属性:

名称 类型 默认值 必填 描述
muted boolean false 视频是否静音播放。
src string - 播放视频内容的路径。
autoplay boolean false 视频是否自动播放。
controls boolean true 控制视频播放的控制栏是否显示,如果设置为false,则不显示控制栏。默认为true,由系统决定显示或隐藏控制栏。

样式

除支持通用样式外,还支持如下样式:

名称 类型 默认值 必填 描述
object-fit string contain 视频源的缩放类型,如果poster设置了值,那么此配置还会影响视频海报的缩放类型,可选值参考表 object-fit 类型说明。

表1 object-fit 类型说明

类型 描述
fill 不保持宽高比进行放大缩小,使得图片填充满显示边界。

事件

除支持通用事件外,还支持如下事件:

名称 参数 描述
prepared { duration: value }5+ 视频准备完成时触发该事件,通过duration可以获取视频时长,单位为s。
start - 播放时触发该事件。
pause - 暂停时触发该事件。
finish - 播放结束时触发该事件。
error - 播放失败时触发该事件。
seeking { currenttime: value } 操作进度条过程时上报时间信息,单位为s。
seeked { currenttime: value } 操作进度条完成后,上报播放时间信息,单位为s。
timeupdate { currenttime: value } 播放进度变化时触发该事件,单位为s,更新时间间隔为250ms。

方法

除支持通用方法外,还支持如下方法:

名称 参数 描述
start - 请求播放视频。
pause - 请求暂停播放视频。
setCurrentTime { currenttime: value } 指定视频播放的进度位置,单位为s。

说明: 在attached组件生命周期回调后,可以调用上述组件方法。

示例

<!-- xxx.hml -->
<div class="container">
  <video id='videoId' src='/common/myDeram.mp4' muted='false' autoplay='false'
         controls='true' onprepared='preparedCallback' onstart='startCallback'
         onpause='pauseCallback' onfinish='finishCallback' onerror='errorCallback'
         onseeking='seekingCallback' onseeked='seekedCallback' 
         ontimeupdate='timeupdateCallback'
         style="object-fit:fill; width:80%; height:400px;"
         onclick="change_start_pause">
   </video>
</div>
/* xxx.css */
.container {
  justify-content: center;
  align-items: center;
}
// xxx.js
export default {
  data: {
    event:'',
    seekingtime:'',
    timeupdatetime:'',
    seekedtime:'',
    isStart: true,
    duration: '',
  },
  preparedCallback:function(e){ this.event = '视频连接成功'; this.duration = e.duration;},
  startCallback:function(){ this.event = '视频开始播放';},
  pauseCallback:function(){ this.event = '视频暂停播放'; },
  finishCallback:function(){ this.event = '视频播放结束';},
  errorCallback:function(){ this.event = '视频播放错误';},
  seekingCallback:function(e){ this.seekingtime = e.currenttime; },
  timeupdateCallback:function(e){ this.timeupdatetime = e.currenttime;},
  change_start_pause: function() {
    if(this.isStart) {
      this.$element('videoId').pause();
      this.isStart = false;
    } else {
      this.$element('videoId').start();
      this.isStart = true; 
    }
  },
}