video-媒体组件-兼容JS的类Web开发范式（ArkUI.Full）-JS组件-ArkUI（方舟UI框架）-应用框架

说明

从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 }⁵⁺	视频准备完成时触发该事件，通过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; 
    }
  },
}