更新记录
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>