uni-app中video上下滑动播放的核心限制是小程序平台不支持自动播放+静音+全屏外渲染组合,需单video复用src、监听可视区域、避免scroll-view包裹,并针对各平台做兼容处理。

uni-app 中用 video 组件实现上下滑动播放的核心限制
原生 video 在小程序平台(尤其是微信、抖音系)不支持「自动播放+静音+全屏外渲染」的组合,这是卡住「抖音式体验」的第一道墙。H5 端能靠 autoplay + muted + playsinline 撑住,但小程序端必须走 createVideoContext + 手动控制,且无法绕过「用户首次触摸后才能播放」的策略。
真正能稳定复现抖音滑动逻辑的,是「单页只挂一个 video,通过切换 src 和重置状态来复用」,而不是为每个 item 都建一个 video——后者在 iOS 微信里极易触发内存警告或播放卡顿。
如何让 video 在滑动时自动播放/暂停
关键不是监听 scroll,而是监听 onReachBottom 和页面级 onPageScroll(仅 H5)或使用 uni.createSelectorQuery() 获取当前可视区域 video 的 top 值。更可靠的做法是:用 uni.getSystemInfoSync().windowHeight 计算视口高度,再结合 boundingClientRect 判断当前 video 是否「垂直居中 ±15%」。
- 必须在
mounted后调用this.$nextTick再执行查询,否则 DOM 未就绪 - 不要用
scroll-view包video,它会截断原生 video 的手势事件;改用普通view+position: sticky或transform: translateY模拟滚动 - 每次滑动后,先
context.pause()上一个,再context.src = newSrc+context.play(),避免音频残留
video 在不同平台的行为差异与兜底方案
微信小程序:不支持 objectFit: cover,必须用 width: 100%; height: 100%; object-fit: cover; 并配合 video 的 class 加 !important;抖音小程序则要求 enable-danmu 关闭,否则首帧黑屏。
抖音公开数据智能分析工具。支持关键词搜索排序、抖人作品抓取、实时热榜获取,适用于短视频营销、竞品分析和热点监控,助力爆款内容策划与流量追踪。
H5 端需额外处理:webkit-playsinline 和 x5-playsinline 必须同时存在,否则安卓 QQ 浏览器会强制全屏;iOS Safari 要求 muted 属性存在且初始值为 true,哪怕后续 JS 改成 false 也不影响自动播放。
- 安卓微信:
video的binderror会返回1002(解码失败),此时应降级为 poster 图片 + 播放按钮 - 抖音小程序:不能用
uni.createVideoContext,必须用组件上的ref+this.$refs.video.play() - 所有平台都建议加
preload="auto",但实测抖音小程序忽略该属性,需提前用uni.downloadFile缓存视频到本地再赋值src
滑动卡顿和内存暴涨的三个硬性规避点
真机上最常被忽略的是:没做 video 实例销毁、没限制预加载数量、没关闭非活跃项的 poster 动画。
- 每次
onHide或离开当前 tab 时,必须手动调用context.stop()+context.destroy()(如果支持),否则 iOS 微信后台持续占用 GPU - 预加载最多保留当前项 + 上下各 1 条,超出的
src设为空字符串,防止系统缓存堆积 - poster 图片禁止用
animation或transition,尤其不能对video父容器设opacity动画,会触发全图层重绘
滑动响应延迟超过 100ms 就明显可感,这时候别优化 JS,先检查是否在 watch 里直接调用了 play() —— 它是异步的,要等 canplay 回调才真正就绪。










