参数 类型 默认值 必填 说明
    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}