# video

手机

# 概述

Video 组件，提供了视频播放器的功能，入门请参考教程

# 子组件

不支持

# 属性

支持通用属性

名称 类型 默认值 必填 描述
src <uri> - 否 视频播放内容的 uri
autoplay <boolean> false 否 渲染后是否自动播放
poster <uri> - 否 视频预览海报
controls <boolean> true 否 是否显示默认控件
muted <boolean> false 否 是否静音播放

备注：如果开发者手动调用requestFullScreen方法进入全屏，将根据此方法的传入参数screenOrientation设置全屏方向。

示例代码：

<video src="xxx.mp4" orientation="portrait"></video>
1

# 样式

支持通用样式

名称 类型 默认值 必填 描述
object-fit contain | cover | fill | none | scale-down contain 否 视频源的缩放类型

object-fit 类型

类型 描述
contain 保持宽高比，缩小或者放大，使得视频完全显示在显示边界内，居中显示
cover 保持宽高比，缩小或者放大，使得两边都大于或等于显示边界，居中显示
fill 不保存宽高比，填充满显示边界
none 居中，无缩放
scale-down 保持宽高比，缩小或保持不变，取 contain 和 none 中显示较小的一个，居中显示

# 事件

支持通用事件

名称 参数 描述
prepared {duration: value(秒)} 视频连接成功时触发
start - 开始播放时触发
pause - 暂停时触发
finish - 播放结束时触发
error - 播放失败时触发
seeking {currenttime: value(秒)} 播放进度条滑动时触发
seeked {currenttime: value(秒)} 播放进度条滑动放开时触发
timeupdate {currenttime: value(秒)} 播放进度变化时触发，触发频率 4HZ
fullscreenchange {fullscreen: fullscreenValue} 视频进入和退出全屏时触发

# 方法

名称 参数 描述
start - 开始播放视频
pause - 暂停播放视频
setCurrentTime {currenttime: value(秒)} 指定视频播放位置
requestFullscreen { screenOrientation : "portrait" | "landscape" } minPlatformVersion < 1050: 默认参数为 "landscape"; minPlatformVersion >= 1050: 默认参数为 "portrait". 请求进入全屏模式
exitFullscreen - 视频退出全屏

# video   示例代码

查看示例代码 (opens new window)

说明:

  1. 支持 HTTP/HTTPS/RTSP 协议
  2. 在主流的视频编码格式(如：H.263，H.264，MPEG-4 等)和主流的音频编码格式(AAC，FLAC，MP3 等)下，支持主流的音视频封装格式如：MPEG-4(.mp4)，3GPP(.3gp)，MPEG-TS(.ts，not seekable)，Matroska(.mkv)，Ogg(.ogg)等