bl.createVideo(Object object)
基础库 3.12.0 开始支持,低版本需要做兼容处理
创建视频
返回值
Video
一个视频对象,可以通过设置该对象上的属性和调用该对象上的方法来控制视频
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
x | number | 0 | 否 | 视频的左上角横坐标 | 3.12.0 |
y | number | 0 | 否 | 视频的左上角纵坐标 | 3.12.0 |
width | number | 300 | 否 | 视频的宽度 | 3.12.0 |
height | number | 150 | 否 | 视频的高度 | 3.12.0 |
src | string | 是 | 视频的资源地址 | 3.12.0 | |
poster | string | 否 | 视频的封面 | 3.12.0 | |
initialTime | number | 0 | 否 | 视频的初始播放位置,单位为 s 秒 | 3.12.0 |
playbackRate | number | 1.0 | 否 | 视频的播放速率,有效值有 0.5、0.8、1.0、1.25、1.5 | 3.12.0 |
live (暂不支持直播源) | boolean | false | 否 | 视频是否为直播 | 3.12.0 |
objectFit | string | 'contain' | 否 | 视频的缩放模式 | 3.12.0 |
controls | boolean | true | 否 | 视频是否显示控件 | 3.12.0 |
autoplay | boolean | false | 否 | 视频是否自动播放 | 3.12.0 |
loop | boolean | false | 否 | 视频是否是否循环播放 | 3.12.0 |
muted | boolean | false | 否 | 视频是否禁音播放 | 3.12.0 |
obeyMuteSwitch | boolean | false | 否 | 视频是否遵循系统静音开关设置(仅iOS) | 3.12.0 |
enableProgressGesture | boolean | true | 否 | 是否启用手势控制播放进度 | 3.12.0 |
enablePlayGesture | boolean | false | 否 | 是否开启双击播放的手势 | 3.12.0 |
showCenterPlayBtn | boolean | true | 否 | 是否显示视频中央的播放按钮 | 3.12.0 |
underGameView | boolean | false | 否 | 视频是否显示在游戏画布之下(配合 Canvas.getContext('webgl', {alpha: true}) 使主屏canvas实现透明效果) | 3.12.0 |
object.objectFit 的合法值
值 | 说明 | 最低版本 |
---|---|---|
fill | 填充,视频拉伸填满整个容器,不保证保持原有长宽比例 | 3.12.0 |
contain | 包含,保持原有长宽比例。保证视频尺寸一定可以在容器里面放得下。因此,可能会有部分空白 | 3.12.0 |
cover | 覆盖,保持原有长宽比例。保证视频尺寸一定大于容器尺寸,宽度和高度至少有一个和容器一致。因此,视频有部分会看不见 | 3.12.0 |