- qq.createVideo
- Video
- 属性
- number x
- number y
- number width
- number height
- number src
- number poster
- number initialTime
- number playbackRate
- 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
- .destroy
- .exitFullScreen
- .offEnded
- .offError
- .offPause
- .offPlay
- .offTimeUpdate
- .offWaiting
- .onEnded
- .onError
- .onPause
- .onTimeUpdate
- .onWaiting
- .pause
- .play
- .requestFullScreen
- .seek
- .stop
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