Skip to content

sud.createVideo ​

JS
Video sud.createVideo(Object object)

创建一个视频对象。

参数 ​

Object object ​

属性类型默认值必填说明
xnumber0是视频的左上角横坐标
ynumber0是视频的左上角纵坐标
widthnumber0是视频的宽度
heightnumber0是视频的高度
srcstring是视频的资源地址
posterstring否视频的封面
initialTimenumber0否视频的初始播放位置,单位为 s 秒
playbackRatenumber1.0否视频的播放速率,有效值有 0.5、0.8、1.0、1.25、1.5
livebooleanfalse否视频是否为直播
objectFitstring'contain'否视频的缩放模式,支持 fill、contain、cover
controlsbooleantrue否视频是否显示控件
showProgressbooleantrue否是否显示视频底部进度条
showProgressInControlModebooleantrue否是否显示控制栏的进度条
backgroundColorstring'#000000'否视频背景颜色
autoplaybooleanfalse否视频是否自动播放
loopbooleanfalse否视频是否是否循环播放
mutedbooleanfalse否视频是否禁音播放
obeyMuteSwitchbooleanfalse否视频是否遵循系统静音开关设置(仅 iOS)
enableProgressGesturebooleantrue否是否启用手势控制播放进度
enablePlayGesturebooleanfalse否是否开启双击播放的手势
showCenterPlayBtnbooleantrue否是否显示视频中央的播放按钮
underGameViewbooleanfalse否视频是否显示在游戏画布之下
autoPauseIfNavigatebooleantrue否视频跳转后自动暂停播放
autoPauseIfOpenNativebooleantrue否视频跳转原生页后自动暂停播放
preloadstringmetadata否视频预加载策略。合法值:none:不预加载任何内容;metadata:加载到足够解析 metadata 后停止;auto:尽可能多地加载;空字符串 "":等同于 auto。注意:preload == none 时不校验 src,也不加载非自定义封面
volumenumber1否视频音量,合理范围为 [0.0, 1.0]

objectFit 的合法值 ​

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

返回值 ​

  • Video: 视频对象