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 |