小程序开放平台

文档中心
表单组件
基础内容
媒体组件
image
video
video-player
地图
视图容器
导航组件
开放能力
画布

video-player

开发
>
组件
>
媒体组件
>
video-player
>
更新时间:2024-12-17 10:43:39

video-player

属性
类型
默认值
必填
说明
album-idstring原片id,获取方式可见【内测中】短剧内容库接入文档
episode-idstring剧集id,获取方式可见【内测中】短剧内容库接入文档
durationnumber指定视频时长
controlsbooleantrue是否显示默认播放控件(播放/暂停按钮、播放进度、时间)
autoplaybooleanfalse是否自动播放
loopbooleanfalse是否循环播放
mutedbooleanfalse是否静音播放
show-mute-btnbooleanfalse是否展示静音按钮
initial-timenumber0指定视频初始播放位置
show-progressbooleantrue若不设置,宽度大于240时才会显示
show-fullscreen-btnbooleantrue是否显示全屏按钮
show-play-btnbooleantrue是否显示视频底部控制栏的播放按钮
show-center-play-btnbooleantrue是否显示视频中间的播放按钮
object-fitstringcontain当视频大小与 video 容器大小不一致时,视频的表现形式
posterstring当前标题视频封面的图片网络资源地址或云文件ID
bindplayeventhandle当开始/继续播放时触发play事件
bindpauseeventhandle当暂停播放时触发 pause 事件
bindendedeventhandle当播放到末尾时触发 ended 事件
bindtimeupdateeventhandle播放进度变化时触发,event.detail = {currentTime, duration} 。触发频率 250ms 一次
bindfullscreenchangeeventhandle视频进入和退出全屏时触发,event.detail = {fullScreen, direction},direction 有效值为 vertical 或 horizontal
bindwaitingeventhandle视频出现缓冲时触发
binderroreventhandle视频播放出错时触发
bindprogresseventhandle加载进度变化时触发,只支持一段加载。event.detail = {buffered},百分比
bindloadedmetadataeventhandle视频元数据加载完成时触发。event.detail = {width, height, duration}
bindgetsourceeventhandle视频元数据加载完成时触发。event.detail = {width, height, duration}

object-fit 的合法值

说明
contain包含
fill填充
cover覆盖

video 支持的播放格式

未来 video 会接入同层组件,与 web 版本支持格式无法完全对齐,所以这里推荐使用可以对齐的格式

格式
IOS
Android
mp4(推荐)
mov (推荐)
m4v
3gpXX
aviXX
webmX

组件示例