更新记录

1.0.0(2025-09-26) 下载此版本

支持视频前贴


平台兼容性

uni-app(3.6.5)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× × × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × ×

uni-video-ad

基于video组件和ad组件实现的模拟视频前贴功能。

属性说明

属性名 类型 默认值 说明
adpid String 广告位id
src String 要播放视频的资源地址
autoplay Boolean false 是否自动播放
loop Boolean false 是否循环播放
muted Boolean false 是否静音播放
initial-time Number 指定视频初始播放位置,单位为秒(s)。
duration Number 指定视频时长,单位为秒(s)。
controls Boolean true 是否显示默认播放控件(播放/暂停按钮、播放进度、时间)
danmu-list Object Array 弹幕列表
danmu-btn Boolean false 是否显示弹幕按钮,只在初始化时有效,不能动态变更
enable-danmu Boolean false 是否展示弹幕,只在初始化时有效,不能动态变更
page-gesture Boolean false 在非全屏模式下,是否开启亮度与音量调节手势
direction Number 设置全屏时视频的方向,不指定则根据宽高比自动判断。有效值为 0(正常竖向), 90(屏幕逆时针90度), -90(屏幕顺时针90度)
show-progress Boolean true 若不设置,宽度大于240时才会显示
show-fullscreen-btn Boolean true 是否显示全屏按钮
show-play-btn Boolean true 是否显示视频底部控制栏的播放按钮
show-center-play-btn Boolean true 是否显示视频中间的播放按钮
show-loading Boolean true 是否显示loading控件
enable-progress-gesture Boolean true 是否开启控制进度的手势
object-fit String contain 当视频大小与 video 容器大小不一致时,视频的表现形式。contain:包含,fill:填充,cover:覆盖
poster String 视频封面的图片网络资源地址,如果 controls 属性值为 false 则设置 poster 无效
show-mute-btn Boolean false 是否显示静音按钮
title String 视频的标题,全屏时在顶部展示
enable-play-gesture Boolean false 是否开启播放手势,即双击切换播放/暂停
vslide-gesture Boolean false 在非全屏模式下,是否开启亮度与音量调节手势(同 page-gesture)
vslide-gesture-in-fullscreen Boolean true 在全屏模式下,是否开启亮度与音量调节手势
codec String hardware 解码器选择,hardware:硬解码(硬解码可以增加解码算力,提高视频清晰度。少部分老旧硬件可能存在兼容性问题);software:ffmpeg 软解码;
http-cache Boolean true 是否对 http、https 视频源开启本地缓存。缓存策略:开启了此开关的视频源,在视频播放时会在本地保存缓存文件,如果本地缓存池已超过100M,在进行缓存前会清空之前的缓存(不适用于m3u8等流媒体协议)
play-strategy Number 0 播放策略,0:普通模式,适合绝大部分视频播放场景;1:平滑播放模式(降级),增加缓冲区大小,采用open sl解码音频,避免音视频脱轨的问题,可能会降低首屏展现速度、视频帧率,出现开屏音频延迟等。 适用于高码率视频的极端场景;2: M3U8优化模式,增加缓冲区大小,提升视频加载速度和流畅度,可能会降低首屏展现速度。 适用于M3U8在线播放的场景
header Object HTTP 请求 Header
is-live Boolean false 是否为直播源
@play EventHandle 当开始/继续播放时触发play事件
@pause EventHandle 当暂停播放时触发 pause 事件
@ended EventHandle 当播放到末尾时触发 ended 事件
@timeupdate EventHandle 播放进度变化时触发,event.detail = {currentTime, duration} 。触发频率 250ms 一次
@fullscreenchange EventHandle 当视频进入和退出全屏时触发,event.detail = {fullScreen, direction},direction取为 vertical 或 horizontal
@waiting EventHandle 视频出现缓冲时触发
@error EventHandle 视频播放出错时触发
@progress EventHandle 加载进度变化时触发,只支持一段加载。event.detail = {buffered},百分比
@loadeddata EventHandle 视频资源开始加载时触发
@loadstart EventHandle 开始加载数据
@seeked EventHandle 拖动进度条结束
@seeking EventHandle 正在拖动进度条
@loadedmetadata EventHandle 视频元数据加载完成时触发。event.detail = {width, height, duration}
@fullscreenclick EventHandle 视频播放全屏播放时点击事件。event.detail = { screenX:"Number类型,点击点相对于屏幕左侧边缘的 X 轴坐标", screenY:"Number类型,点击点相对于屏幕顶部边缘的 Y 轴坐标", screenWidth:"Number类型,屏幕总宽度", screenHeight:"Number类型,屏幕总高度"}
@controlstoggle EventHandle 切换 controls 显示隐藏时触发。event.detail = {show}

方法说明

方法 参数 说明
play 播放
pause 暂停
seek position 跳转到指定位置,单位 s
stop 停止视频
sendDanmu danmu 发送弹幕,danmu 包含两个属性 text, color
playbackRate rate 设置倍速播放,支持的倍率有 0.5/0.8/1.0/1.25/1.5。微信基础库2.6.3 起支持 2.0 倍速
requestFullScreen 进入全屏,可传入{direction}参数,详见 video 组件文档
exitFullScreen 退出全屏
showStatusBar 显示状态栏,仅在iOS全屏下有效
hideStatusBar 隐藏状态栏,仅在iOS全屏下有效

video标签不同的是,调用方法时需要通过ref获取对象然后调用指定方法,参考:

pushFs() {
    this.$refs["videoSize"].requestFullScreen({direction:-90})
},

完整示例参考

<template>
    <view>
        <button @click="pushFs">点击全屏</button>
        <uni-video-ad ref="videoSize" src="https://web-ext-storage.dcloud.net.cn/native/doc/android/debug-native-video.mov"
            adpid="***" style="width: 750rpx;height: 300px;" autoplay="true" @stop="onStop"
            @pause="onStop"></uni-video-ad>
    </view>
</template>

<script>
    export default {
        data() {
            return {
                title: 'Hello',
            }
        },
        onLoad() {

        },
        methods: {
            pushFs() {
                this.$refs["videoSize"].requestFullScreen({direction:-90})
            },
            onerror(e) {
                console.log(JSON.stringify(e))
            },
            onStop() {
                console.log("视频暂停了")
            }
        }
    }
</script>

<style>
    .video {
        width: 100%;
        height: 200px;
    }
</style>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。