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 视频的总时长,单位为秒

.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