sud.createVideo
JS
Video sud.createVideo(Object object)创建一个视频对象。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| x | number | 0 | 是 | 视频的左上角横坐标 |
| y | number | 0 | 是 | 视频的左上角纵坐标 |
| width | number | 0 | 是 | 视频的宽度 |
| height | number | 0 | 是 | 视频的高度 |
| 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' | 否 | 视频的缩放模式,支持 fill、contain、cover |
| controls | boolean | true | 否 | 视频是否显示控件 |
| showProgress | boolean | true | 否 | 是否显示视频底部进度条 |
| showProgressInControlMode | boolean | true | 否 | 是否显示控制栏的进度条 |
| backgroundColor | string | '#000000' | 否 | 视频背景颜色 |
| autoplay | boolean | false | 否 | 视频是否自动播放 |
| loop | boolean | false | 否 | 视频是否是否循环播放 |
| muted | boolean | false | 否 | 视频是否禁音播放 |
| obeyMuteSwitch | boolean | false | 否 | 视频是否遵循系统静音开关设置(仅 iOS) |
| enableProgressGesture | boolean | true | 否 | 是否启用手势控制播放进度 |
| enablePlayGesture | boolean | false | 否 | 是否开启双击播放的手势 |
| showCenterPlayBtn | boolean | true | 否 | 是否显示视频中央的播放按钮 |
| underGameView | boolean | false | 否 | 视频是否显示在游戏画布之下 |
| autoPauseIfNavigate | boolean | true | 否 | 视频跳转后自动暂停播放 |
| autoPauseIfOpenNative | boolean | true | 否 | 视频跳转原生页后自动暂停播放 |
| preload | string | metadata | 否 | 视频预加载策略。合法值:none:不预加载任何内容;metadata:加载到足够解析 metadata 后停止;auto:尽可能多地加载;空字符串 "":等同于 auto。注意:preload == none 时不校验 src,也不加载非自定义封面 |
| volume | number | 1 | 否 | 视频音量,合理范围为 [0.0, 1.0] |
objectFit 的合法值
| 值 | 说明 |
|---|---|
| fill | 填充,视频拉伸填满整个容器,不保证保持原有长宽比例 |
| contain | 包含,保持原有长宽比例。保证视频尺寸一定可以在容器里面放得下。因此,可能会有部分空白 |
| cover | 覆盖,保持原有长宽比例。保证视频尺寸一定大于容器尺寸,宽度和高度至少有一个和容器一致。因此,视频有部分会看不见 |
返回值
- Video: 视频对象
