Video qg.createVideo(object)

支持最低平台版本号'1040' (minPlatformVersion>='1040')

创建视频

返回值

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

参数

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' 视频的缩放模式
autoplay boolean false 视频是否自动播放
loop boolean false 视频是否是否循环播放
muted boolean false 视频是否禁音播放
controls boolean true 视频是否显示控件
showCenterPlayBtn boolean false 是否显示视频中央的播放按钮
enableProgressGesture boolean false 是否启用手势控制播放进度

object.objectFit 的合法值

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

方法

Video.play()

播放视频

Video.pause()

暂停视频

Video.stop()

停止视频

Video.seek(number time)

视频跳转

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

Video.requestFullScreen()

视频全屏

Video.destroy()

销毁视频

Video.exitFullScreen()

视频退出全屏

Video.onEnded(function callback)

监听视频播放到末尾事件

Video.onError(function callback)

监听视频错误事件

  • function callback 视频错误事件的回调函数

  • Object res 错误回调函数被调用时传入的参数

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

Video.onPause(function callback)

监听视频暂停事件

Video.onPlay(function callback)

监听视频播放事件

Video.onTimeUpdate(function callback)

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

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

  • Object res 回调函数被调用时传入的参数

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

Video.onWaiting(function callback)

监听视频缓冲事件

Video.offEnded(function callback)

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

Video.offError(function callback)

取消监听视频错误事件

Video.offPause(function callback)

取消监听视频暂停事件

ideo.offPlay(function callback)

取消监听视频播放事件

Video.offTimeUpdate(function callback)

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

Video.offWaiting(function callback)

取消监听视频缓冲事件


示例代码:

var video = qg.createVideo({
    x: 0,
    y: 0,
    width: 300,
    height: 150,
    src: "res/demo.mp4",
    poster: "res/poster.jpg",
    playbackRate: 1.0,
    objectFit: "contain",
    autoplay: false,
});

video.onPlay(function() {
    console.log("video play");
});
video.play();
© 2020 OPPO. All rights reserved.

results matching ""

    No results matching ""