企业官网建设流程全解析

GSYVideoPlayer 列表播放指南：3步实现无缝切换不黑屏

【免费下载链接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support项目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer

你是不是也在做视频列表时，一滑动画面就断、切到下一集就闪黑屏，小窗口和全屏的状态还对不上？用GSYVideoPlayer的列表播放能力，配合全局播放管理器，你也能做出"滑走不卡、切播不黑"的流畅体验。

先搞懂核心机制：为什么"无缝切换"行得通

列表播放的难点不在"播"，而在"只有一个播放器，却要在 N 个列表项里流转"。GSYVideoPlayer 的做法是：全 App 共享一个全局管理器GSYVideoManager，同一时刻只允许一个视频占用解码资源；每个播放器通过playTag + playPosition两个标记告诉管理器"我属于哪个列表的第几项"。这样滚动时你就能根据"播放位置是否还在可视区间"决定释放、转小窗还是恢复，而不是自己到处找 View。

下面这张架构图里，播放内核层、Manager 交互层和 UI 层的分工一目了然：

选对方案：两种列表形态，一张表做决定

💡 经验法则：视频超过一屏且用户爱快速滑动，就选方案 B；教学、详情类长列表选方案 A 足够。

动手实现：以方案 B 为主线，3 步搭起来

先把示例工程拉下来参考（官方使用文档 里有完整 API 说明）：

git clone https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer

参考实现位于 simple/ 目录，下面是三个关键步骤。

第 1 步：把列表项做轻，只留封面和容器

做什么：item 里不放播放器，只放一个占位FrameLayout和播放按钮。关键代码：

<FrameLayout android:id="@+id/list_item_container" android:layout_width="match_parent" android:layout_height="@dimen/post_media_height" />

如何验证：滑动列表时用 Layout Inspector 观察，item 内不再出现SurfaceView/TextureView，滚动帧率应明显平稳。

第 2 步：配置 GSYVideoHelper 构建器

做什么：用 Builder 声明播放行为，例如边播边缓存、需要横屏锁定。关键代码：

smallVideoHelper = new GSYVideoHelper(this); builder = new GSYVideoHelper.GSYVideoHelperBuilder() .setCacheWithPlay(true) .setNeedLockFull(true) .setShowFullAnimation(false); smallVideoHelper.setGsyVideoOptionBuilder(builder);

如何验证：播放一个 mp4 后检查缓存目录有落盘文件，说明边播边缓存生效。

第 3 步：滚动监听里做"三态决策"

做什么：根据播放位置相对可视区间的位置，决定转小窗或还原。关键代码：

if (position < firstVisibleItem || position > lastVisibleItem) { if (!smallVideoHelper.isSmall()) { int size = CommonUtil.dip2px(this, 150); smallVideoHelper.showSmallVideo(new Point(size, size), false, true); } } else if (smallVideoHelper.isSmall()) { smallVideoHelper.smallVideoToNormal(); }

如何验证：播放中快速上滑，播放器自动缩成右下角小窗且不中断；再滑回原位，小窗还原为正常大小——这就是"无缝"。

最后别忘生命周期兜底：onPause()里调GSYVideoManager.onPause()，onDestroy()里调smallVideoHelper.releaseVideoPlayer()和GSYVideoManager.releaseAllVideos()。

避坑指南：3 个高频问题的"现象→原因→解决"

1. 现象：滑走了还响声音，像多个视频同时播。原因：没有用 playTag/position 区分归属，误伤了别的管理器。解决：判断前先校验getPlayTag()与getPlayPosition()，只对"自己列表的播放项"做释放。

2. 现象：切换下一集瞬间黑屏闪一下。原因：封面还没显示，Surface 先黑场。解决：给播放器背景设为Color.BLACK，并在setUpLazy前先loadCoverImage挂上封面，让封面遮住建流过程。

3. 现象：全屏播放时按返回键，页面直接没了。原因：返回事件没先交还给播放器退出全屏。解决：在返回回调里先走GSYVideoManager.backFromWindowFull(this)，返回 false 再finish()。

总结

列表播放的本质只有一句话：全局唯一管理器 + 位置标记 + 滚动时三态决策。照着这份清单过一遍即可：

• 每个播放器都设置了 playTag 和 playPosition
• 滚动监听覆盖了"滑出释放 / 转小窗 / 还原"三种分支
• onPause/onDestroy里完成了暂停与全量释放
• 长列表用轻列表项，短列表可直接内嵌播放器

现在就打开 demo 里的 SimpleListVideoActivityMode2，把三步改成你自己的业务列表吧！

【免费下载链接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support项目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer