讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app实现视频滑动全屏播放 uni-app仿抖音短视频源码逻辑

秋墨吖_6159

秋墨吖_6159

发布时间:2026-05-08 06:15:00

|

821人浏览过

|

来源于php中文网

原创

uni-app中video组件无法响应滑动全屏,因iOS/安卓WebView中video为原生控件,事件穿透被拦截且不支持z-index;应使用scroll-view容器配合ref定位可视区中心视频并控制播放。

uni-app实现视频滑动全屏播放 uni-app仿抖音短视频源码逻辑

uni-app 中 video 组件无法响应滑动全屏的常见原因

直接在 video 上绑定 @touchstart 或监听 scroll-view 滚动,大概率失效——因为 video 在 iOS(尤其是微信小程序)和部分安卓 WebView 中是原生控件,事件穿透被拦截,且不支持 z-index 层级覆盖。你看到的“滑动”其实是页面滚动,不是视频本身在动。

真正可行的路径是:用 scroll-view 做容器,每个 video 单独占满视口,靠滚动位置切换「当前播放项」,而非让单个 video 跟着手指移动。

  • 必须设置 scroll-y="false" + scroll-x="true"(横向滑动)或更常用的是 scroll-y="true"(竖向滑动),并开启 bounce="false" 防止回弹干扰判断
  • video 不能设为 position: absolute 或脱离文档流,否则 scroll-view 无法正确计算滚动高度
  • 真机调试时,iOS 微信环境需额外加 enable-play-gesture="true" 才允许手势触发全屏(否则点按无效)

如何用 scroll-view + ref 定位当前播放视频

核心不是“滑动视频”,而是“滑动后识别哪个视频在可视区中心”,再调用它的 play()、pause() 方法。uni-app 的 scroll-view 不提供滚动帧回调,得靠 @scroll 事件 + 节流 + 元素位置计算。

实操建议:

抖音快手短视频创作专家
抖音快手短视频创作专家

抖音/快手短视频全栈专家。提供内容策划、脚本撰写、爆款拆解、算法运营、带货策略服务。适用于:创作短视频脚本、制定内容选题、分析爆款视频、制定平台运营策略、撰写带货话术、设计标题封面、理解算法逻辑。服务对象:短视频创作者、自媒体运营、品牌方、MCN机构。

下载
  • 给每个 video 加 :ref="'video' + index",并在 onReady 后用 this.$refs[`video${index}`][0].getBoundingClientRect() 获取位置(注意:H5 和小程序 API 返回字段不同,小程序用 uni.createSelectorQuery() 更稳)
  • 在 @scroll 回调中,只检查滚动 y 值是否落在当前 video 区域的中间 1/3 范围内,避免频繁切换
  • 暂停其他所有 video,只对命中项调用 play();若离开可视区超 200ms,再 pause()(防内存占用)
  • H5 端可直接用 IntersectionObserver 替代手动计算,但小程序不支持,需条件编译

video 全屏逻辑在不同平台的表现差异

uni-app 的 video 组件底层映射到各端原生能力,行为不一致是常态:

  • 微信小程序:调用 requestFullScreen() 后会进入系统全屏页,返回时触发 @fullscreenchange,但无法自定义状态栏/导航栏样式
  • App(iOS):player-type="landscape" 可强制横屏,但需在 manifest.json 中开启「横屏支持」,否则无效
  • H5:无真正全屏,只能用 webkitRequestFullscreen() 模拟,且部分安卓浏览器禁止自动全屏(需用户手势触发)
  • 抖音式体验关键点:全屏时不显示 controls,用自定义按钮控制播放/点赞,且退出全屏后要恢复原 scroll-view 位置(需记录 lastScrollTop)

性能与体验避坑点

大量 video 同时存在会导致内存飙升、滑动卡顿,尤其低端安卓机。这不是代码写得不好,而是原生限制。

  • 不要一次性渲染全部视频,用「可视区 + 前后各 1 个」的懒加载策略(类似 virtual-list 思路)
  • 每个 video 必须设 preload="auto"(小程序)或 preload="metadata"(H5),否则首帧加载延迟明显
  • 暂停时务必调用 pause() 并设 src=""(或 src="data:,"),否则音频可能后台继续播放
  • 安卓部分机型(如华为 EMUI)会强制关闭后台 video 解码,需监听 @error 并重置 src

最麻烦的其实是「滑动过程中视频突然黑屏或卡住」——这通常是因为 scroll 事件太密导致连续调用 play(),而原生 video 尚未 ready。加个 isPlaying 标志位 + canplay 事件守门,比任何节流都管用。

相关文章

抖音极速版(领现金)
抖音极速版(领现金)

抖音极速版是一款可以领现金的短视频app,看视频、拍视频、邀好友,均可获得专属金币红包,助您能轻松赚钱!感兴趣的小伙伴快来保存下载体验吧!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2563

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5543

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6570

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6218

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

883

2024.05.22

html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

4211

2023.10.23

canva可画使用技巧汇总
canva可画使用技巧汇总

本专题汇集了PHP中文网精心整理的Canva可画新手使用技巧大全,专为零基础用户打造。无论你是想制作精美海报、PPT还是社交媒体配图,这里都有从注册登录、模板搜索到AI辅助设计、导出分享的全流程保姆级教程。通过深入浅出的图文指南,帮助你快速跨越设计门槛,轻松掌握Canva可画的实用操作,让每个人都能成为设计达人!

264

2026.05.19

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

40

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn