qq.createVideo

# qq.createVideo

# Video qq.createVideo(Object object)

创建视频

# 参数

# Object object

属性	类型	默认值	必填	说明
x	number	0	否	视频的左上角横坐标
y	number	0	否	视频的左上角纵坐标
width	number	300	否	视频的宽度
height	number	150	否	视频的高度
src	string		是	视频的资源地址
poster	string		是	视频的封面
initialTime	number	0	否	视频的初始播放位置，单位为 s 秒
playbackRate	number	1.0	否	视频的播放速率，有效值有 0.5、0.8、1.0、1.25、1.5
live	boolean	false	否	视频是否为直播
objectFit	string	'contain'	否	视频的缩放模式
controls	boolean	true	否	视频是否显示控件
autoplay	boolean	false	否	视频是否自动播放
loop	boolean	false	否	视频是否是否循环播放
muted	boolean	false	否	视频是否禁音播放
enableProgressGesture	boolean	false	否	是否启用手势控制播放进度
showCenterPlayBtn	boolean	false	否	是否显示视频中央的播放按钮

object.objectFit 的合法值

值	说明
fill	填充，视频拉伸填满整个容器，不保证保持原有长宽比例
contain	包含，保持原有长宽比例。保证视频尺寸一定可以在容器里面放得下。因此，可能会有部分空白
cover	覆盖，保持原有长宽比例。保证视频尺寸一定大于容器尺寸，宽度和高度至少有一个和容器一致。因此，视频有部分会看不见

# 返回值

# Video

一个视频对象，可以通过设置该对象上的属性和调用该对象上的方法来控制视频

# Video

视频对象

# 属性

# number x

视频的左上角横坐标

# number y

视频的左上角纵坐标

# number width

视频的宽度

# number height

视频的高度

# number src

视频的资源地址

# number poster

视频的封面

# number initialTime

视频的初始播放位置，单位为 s 秒

# number playbackRate

视频的播放速率，有效值有 0.5、0.8、1.0、1.25、1.5

# number live

视频是否为直播

# number objectFit

视频的缩放模式

# number controls

视频是否显示控件

# number autoplay

视频是否自动播放

# number loop

视频是否是否循环播放

# number muted

视频是否禁音播放

# boolean enableProgressGesture

是否启用手势控制播放进度

# boolean showCenterPlayBtn

是否显示视频中央的播放按钮

# function onwaiting

视频开始缓冲时触发的回调函数

# function onplay

视频开始播放时触发的回调函数

# function onpause

视频暂停时触发的回调函数

# function onended

视频播放到末尾时触发的回调函数

# function ontimeupdate

每当视频播放进度更新时触发的回调函数

# function onerror

视频发生错误时触发的回调函数

# 方法

# Video.destroy()

销毁视频

# Promise Video.play()

播放视频

# Promise Video.pause()

暂停视频

# Promise Video.stop()

停止视频

# Promise Video.seek(number time)

视频跳转

# Promise Video.requestFullScreen()

视频全屏

# Promise Video.exitFullScreen()

视频退出全屏

# Video.onWaiting(function callback)

监听视频缓冲事件

# Video.offWaiting(function callback)

取消监听视频缓冲事件

# Video.onPlay(function callback)

监听视频播放事件

# Video.offPlay(function callback)

取消监听视频播放事件

# Video.onPause(function callback)

监听视频暂停事件

# Video.offPause(function callback)

取消监听视频暂停事件

# Video.onEnded(function callback)

监听视频播放到末尾事件

# Video.offEnded(function callback)

取消监听视频播放到末尾事件

# Video.onTimeUpdate(function callback)

监听视频播放进度更新事件

# Video.offTimeUpdate(function callback)

取消监听视频播放进度更新事件

# Video.onError(function callback)

监听视频错误事件

# Video.offError(function callback)

取消监听视频错误事件

# .onPlay

# Video.onPlay(function callback)

监听视频播放事件

# 参数

# function callback

视频播放事件的回调函数

# .destroy

# Video.destroy()

销毁视频

# .exitFullScreen

# Promise Video.exitFullScreen()

视频退出全屏

# 返回值

# Promise

视频退出全屏完成的 Promise

# .offEnded

# Video.offEnded(function callback)

取消监听视频播放到末尾事件

# 参数

# function callback

视频播放到末尾事件的回调函数

# .offError

# Video.offError(function callback)

取消监听视频错误事件

# 参数

# function callback

视频错误事件的回调函数

# .offPause

# Video.offPause(function callback)

取消监听视频暂停事件

# 参数

# function callback

视频暂停事件的回调函数

# .offPlay

# Video.offPlay(function callback)

取消监听视频播放事件

# 参数

# function callback

视频播放事件的回调函数

# .offTimeUpdate

# Video.offTimeUpdate(function callback)

取消监听视频播放进度更新事件

# 参数

# function callback

视频播放进度更新事件的回调函数

# .offWaiting

# Video.offWaiting(function callback)

取消监听视频缓冲事件

# 参数

# function callback

视频缓冲事件的回调函数

# .onEnded

# Video.onEnded(function callback)

监听视频播放到末尾事件

# 参数

# function callback

视频播放到末尾事件的回调函数

# .onError

# Video.onError(function callback)

监听视频错误事件

# 参数

# function callback

视频错误事件的回调函数

# 参数

Object res

属性	类型	说明
errMsg	string	错误信息

errMsg 的合法值

值	说明
MEDIA_ERR_NETWORK	当下载时发生错误
MEDIA_ERR_DECODE	当解码时发生错误
MEDIA_ERR_SRC_NOT_SUPPORTED	video 的 src 属性是不支持的资源类型

# .onPause

# Video.onPause(function callback)

监听视频暂停事件

# 参数

# function callback

视频暂停事件的回调函数

# .onTimeUpdate

# Video.onTimeUpdate(function callback)

监听视频播放进度更新事件

# 参数

# function callback

视频播放进度更新事件的回调函数

# 参数

Object res

属性	类型	说明
position	number	当前的播放位置，单位为秒
duration	number	视频的总时长，单位为秒