视频

qg.createVideo(Object object)

创建视频

参数

Object object

objectFit (视频的缩放模式)

返回值 Video

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

属性

Number x

视频的左上角横坐标

Number y

视频的左上角纵坐标

Number width

视频的宽度

Number height

视频的高度

String src

视频的资源地址

String poster

视频的封面

Number initialTime

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

Number playbackRate

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

String objectFit

视频的缩放模式

Boolean controls

视频是否显示控件

Boolean showProgress

是否显示视频底部进度条

Boolean showProgressInControlMode

是否显示视频控制栏进度条

String backgroundColor

视频背景颜色

Boolean autoplay

视频是否自动播放

Boolean loop

视频是否是否循环播放

Boolean muted

视频是否禁音播放

Boolean enableProgressGesture

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

Boolean enablePlayGesture

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

Boolean showCenterPlayBtn

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

方法

Video.play()

播放视频

返回值 Promise

视频播放完成的 Promise

Video.pause()

暂停视频

返回值 Promise

视频暂停完成的 Promise

Video.stop()

停止视频

返回值 Promise

视频停止完成的 Promise

Promise Video.seek(Number time)

视频跳转

参数 Number time

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

返回值 Promise

视频跳转完成的 Promise

Video.requestFullScreen(Number direction)

视频全屏

参数 Number direction

设置全屏时视频的方向

direction 的合法值

返回值 Promise

视频全屏完成的 Promise

Video.destroy()

销毁视频

Video.exitFullScreen()

视频退出全屏

返回值 Promise

视频退出全屏完成的 Promise

Video.onWaiting(function listener)

监听视频由于需要缓冲下一帧而停止时触发

参数 listener

监听视频由于需要缓冲下一帧而停止时触发的监听函数

Video.offWaiting(Function listener)

移除视频由于需要缓冲下一帧而停止时触发的监听函数

参数 listener

onWaiting 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onWaiting(listener);
Video.offWaiting(listener); // 需传入与监听时同一个的函数对象

Video.onEnded(Function listener)

监听视频播放到末尾事件

参数 listener

视频播放到末尾事件的监听函数

Video.offEnded(Function listener)

移除视频播放到末尾事件的监听函数

参数 listener

onEnded 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onEnded(listener);
Video.offEnded(listener); // 需传入与监听时同一个的函数对象

Video.onError(Function listener)

监听视频错误事件

参数 listener(Object res)

视频错误事件的监听函数

Video.offError(Function listener)

移除视频错误事件的监听函数

参数 listener

onError 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onError(listener);
Video.offError(listener); // 需传入与监听时同一个的函数对象

Video.onPause(Function listener)

监听视频暂停事件

参数 listener

视频暂停事件的监听函数

Video.offPause(Function listener)

移除视频暂停事件的监听函数

参数 listener

onPause 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onPause(listener);
Video.offPause(listener); // 需传入与监听时同一个的函数对象

Video.onPlay(Function listener)

监听视频播放事件

参数 listener

视频播放事件的监听函数

Video.offPlay(Function listener)

移除视频播放事件的监听函数

参数 listener

onPlay 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onPlay(listener);
Video.offPlay(listener); // 需传入与监听时同一个的函数对象

Video.onTimeUpdate(Function listener)

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

参数 listener(Object res)

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

Video.offTimeUpdate(Function listener)

移除视频播放进度更新事件的监听函数

参数 listener

onTimeUpdate 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onTimeUpdate(listener);
Video.offTimeUpdate(listener); // 需传入与监听时同一个的函数对象

Video.onProgress(Function listener)

监听视频下载（缓冲）事件

参数 listener(Object res)

视频下载（缓冲）事件的监听函数

Video.offProgress(Function listener)

移除视频下载（缓冲）事件的监听函数

参数 listener

onProgress 传入的监听函数。不传此参数则移除所有监听函数。

示例代码

const listener = function(res) {
  console.log(res);
};

Video.onProgress(listener);
Video.offProgress(listener); // 需传入与监听时同一个的函数对象