qq.createVideo

Video qq.createVideo(Object object)

创建视频

参数

Object object
属性类型默认值必填说明
xnumber0视频的左上角横坐标
ynumber0视频的左上角纵坐标
widthnumber300视频的宽度
heightnumber150视频的高度
srcstring视频的资源地址
posterstring视频的封面
initialTimenumber0视频的初始播放位置,单位为 s 秒
playbackRatenumber1.0视频的播放速率,有效值有 0.5、0.8、1.0、1.25、1.5
livebooleanfalse视频是否为直播
objectFitstring'contain'视频的缩放模式
controlsbooleantrue视频是否显示控件
autoplaybooleanfalse视频是否自动播放
loopbooleanfalse视频是否是否循环播放
mutedbooleanfalse视频是否禁音播放
enableProgressGesturebooleanfalse是否启用手势控制播放进度
showCenterPlayBtnbooleanfalse是否显示视频中央的播放按钮

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

属性类型说明
errMsgstring错误信息

errMsg 的合法值

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

.onPause

Video.onPause(function callback)

监听视频暂停事件

参数

function callback

视频暂停事件的回调函数

.onTimeUpdate

Video.onTimeUpdate(function callback)

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

参数

function callback

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

参数

Object res

属性类型说明
positionnumber当前的播放位置,单位为秒
durationnumber视频的总时长,单位为秒

.onWaiting

Video.onWaiting(function callback)

监听视频缓冲事件

参数

function callback

视频缓冲事件的回调函数

.pause

Promise Video.pause()

暂停视频

返回值

Promise

视频暂停完成的 Promise

.play

Promise Video.play()

播放视频

返回值

Promise

视频播放完成的 Promise

.requestFullScreen

Promise Video.requestFullScreen()

视频全屏

返回值

Promise

视频全屏完成的 Promise

.seek

Promise Video.seek(number time)

视频跳转

参数

number time

视频跳转到指定位置,单位为 s 秒

返回值

Promise

视频跳转完成的 Promise

.stop

Promise Video.stop()

停止视频

返回值

Promise

视频停止完成的 Promise