参数 | 类型 | 默认值 | 必填 | 说明 | ||
---|---|---|---|---|---|---|
src | string |
是 | 要播放视频的资源地址 | |||
duration | number |
否 | 指定视频时长 | |||
controls | boolean |
true |
否 | 是否显示默认播放控件(播放/暂停按钮、播放进度、时间) | ||
danmuList | any[] |
否 | 弹幕列表 | |||
danmuBtn | boolean |
false |
否 | 是否显示弹幕按钮,只在初始化时有效,不能动态变更 | ||
enableDanmu | boolean |
false |
否 | 是否展示弹幕,只在初始化时有效,不能动态变更 | ||
autoplay | boolean |
false |
否 | 是否自动播放 | ||
loop | boolean |
false |
否 | 是否循环播放 | ||
muted | boolean |
false |
否 | 是否静音播放 | ||
initialTime | number |
否 | 指定视频初始播放位置 | |||
pageGesture | boolean |
false |
否 | 在非全屏模式下,是否开启亮度与音量调节手势 | ||
direction | number |
否 | 设置全屏时视频的方向,不指定则根据宽高比自动判断。有效值为 0(正常竖向), 90(屏幕逆时针90度), -90(屏幕顺时针90度) | |||
showProgress | boolean |
true |
否 | 若不设置,宽度大于240时才会显示 | ||
showFullscreenBtn | boolean |
true |
否 | 是否显示全屏按钮 | ||
showPlayBtn | boolean |
true |
否 | 是否显示视频底部控制栏的播放按钮 | ||
showCenterPlayBtn | boolean |
true |
否 | 是否显示视频中间的播放按钮 | ||
enableProgressGesture | boolean |
true |
否 | 是否开启控制进度的手势 | ||
objectFit | `”contain” | “fill” | “cover”` | "contain" |
否 | 当视频大小与 video 容器大小不一致时,视频的表现形式 |
poster | string |
否 | 视频封面的图片网络资源地址,如果 controls 属性值为 false 则设置 poster 无效 | |||
showMuteBtn | boolean |
false |
否 | 是否显示静音按钮 | ||
title | string |
否 | 视频的标题,全屏时在顶部展示 | |||
playBtnPosition | `”bottom” | “center”` | 'bottom' |
否 | 播放按钮的位置 - bottom : controls bar 上- center : 视频中间 |
|
enablePlayGesture | boolean |
false |
否 | 是否开启播放手势,即双击切换播放/暂停 | ||
autoPauseIfNavigate | boolean |
true |
否 | 当跳转到其它小程序页面时,是否自动暂停本页面的视频 | ||
autoPauseIfOpenNative | boolean |
true |
否 | 当跳转到其它微信原生页面时,是否自动暂停本页面的视频 | ||
vslideGesture | boolean |
false |
否 | 在非全屏模式下,是否开启亮度与音量调节手势(同 page-gesture ) |
||
vslideGestureInFullscreen | boolean |
true |
否 | 在全屏模式下,是否开启亮度与音量调节手势 | ||
adUnitId | string |
否 | 视频前贴广告单元ID,更多详情可参考开放能力视频前贴广告 | |||
posterForCrawler | string |
否 | 用于给搜索等场景作为视频封面展示,建议使用无播放 icon 的视频封面图,只支持网络地址 | |||
showCastingButton | boolean |
否 | 显示投屏按钮。只安卓且同层渲染下生效,支持 DLNA 协议 | |||
onPlay | BaseEventOrigFunction<any> |
否 | 当开始/继续播放时触发 play 事件 | |||
onPause | BaseEventOrigFunction<any> |
否 | 当暂停播放时触发 pause 事件 | |||
onEnded | BaseEventOrigFunction<any> |
否 | 当播放到末尾时触发 ended 事件 | |||
onTimeUpdate | BaseEventOrigFunction<onTimeUpdateEventDetail> |
否 | 播放进度变化时触发, 触发频率 250ms 一次 event.detail = {currentTime, duration} |
|||
onFullscreenChange | BaseEventOrigFunction<onFullscreenChangeEventDetail> |
否 | 当视频进入和退出全屏是触发 event.detail = {fullScreen, direction},direction取为 vertical 或 horizontal |
|||
onWaiting | BaseEventOrigFunction<onWaitingEventDetail> |
否 | 当视频进入和退出全屏是触发 event.detail = {fullScreen, direction},direction 取为 vertical 或 horizontal |
|||
onError | BaseEventOrigFunction<any> |
否 | 视频播放出错时触发 | |||
onProgress | BaseEventOrigFunction<onProgressEventDetail> |
否 | 加载进度变化时触发,只支持一段加载 | |||
onLoadedMetaData | BaseEventOrigFunction<any> |
否 | 视频元数据加载完成时触发。event.detail = {width, height, duration} |