GSYVideoPlayerAndroid 视频播放从接入到切换内核的实践笔记【免费下载链接】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如果你的 App 要同时满足 hls、rtsp、弹幕、外挂字幕和投屏又不想被单一内核锁死GSYVideoPlayer 值得一看。它和单内核封装的差异在于IJKPlayer、Media3ExoPlayer、MediaPlayer、AliPlayer 走同一套控制与缓存层运行时可切换。一个控件包四个内核GSYVideoPlayer 是什么GSYVideoPlayer 的价值在分层业务层只操作 StandardGSYVideoPlayer 这类控件内核、缓存、渲染层都能替换。它解决的是这个格式播不了、下个版本换内核业务代码全要重写的老问题。能力面一览完整清单见仓库根目录 README_CN.md类别提供什么协议h263/4/5、HLS、RTSP、RTMP、HTTPS、DASHMedia3等缓存边播边缓存代理缓存默认与 Exo SimpleCache 可换媒体SRT/WebVTT 外挂字幕、弹幕、滤镜水印、GIF 截图、帧截图播放单例/多个同时播放、列表滑动自动播、无缝切换、多清晰度切换窗口全屏/小窗、前后台暂停不黑屏、16K page size 适配扩展DLNA/UPnP 投屏可选模块、Jetpack Compose 接入GSYVideoPlayer 分层架构业务层只碰控件内核、缓存、渲染各自可替换Android 视频播放第一屏接入与最小示例 接入的最快路径是三步加依赖、放控件、调 setUp。// module 的 build.gradleMaven Central implementation io.github.carguo:gsyvideoplayer:14.0.0StandardGSYVideoPlayer videoPlayer findViewById(R.id.video_player); videoPlayer.setUp(https://example.com/video.mp4, true, 视频标题); videoPlayer.setIsTouchWiget(true); // 滑动调节亮度/音量XML 侧只需在布局里声明一行 StandardGSYVideoPlayer。两个容易漏的细节承载播放的 Activity 必须在 manifest 配置 configChangesorientation、screenSize 等否则旋转会重建页面v14 下 ex_so 整包与独立 ABI 模块不要同时引入会重复 so。完整配置见快速上手文档。切换播放内核IJK、Media3、MediaPlayer、AliPlayer同一个控件可以换不同底层内核选型逻辑比较直接内核底层什么时候用IJKPlayer默认FFmpeg n5.1.10格式兼容优先h263、RTSP、RTMP、concat 等Media3ExoPlayerGoogle Media3DASH、HLS 自适应清晰度、SimpleCache 缓存MediaPlayer系统原生要稳、包小只播常见 mp4AliPlayer云内核需要云能力官方已支持 16K page size全局切换就一行缓存层可以一并换PlayerFactory.setPlayManager(IjkPlayerManager.class); // IJK默认 PlayerFactory.setPlayManager(Exo2PlayerManager.class); // Media3 CacheFactory.setCacheManager(ProxyCacheManager.class); // 代理缓存支持所有内核格式支持细节看 DECODERS.md自编译 so 看 BUILD_SO.md。典型业务场景怎么做官方 demo 就是一本样例册绝大多数场景都有可运行示例先照着抄再写代码demo 目录app/src/main/java/com/example/gsyvideoplayer/。列表播放核心是一个播放器、多个控件用 setPlayTag setPlayPosition 标记当前播到哪一项滑出屏幕统一释放生命周期挂 GSYVideoManager 的 onPause / onResume / releaseAllVideos。两种模式的完整代码见 USE.md示例入口在 SimpleListVideoActivityMode1。其他高频场景边播边缓存默认代理缓存即可m3u8 需切 Exo 缓存ExoPlayerCacheManager注意 Exo 缓存目录被锁时会自动回退非缓存路径外挂字幕SRT/WebVTT 跨内核通用Media3 内嵌字幕可桥接到同一套 UI见 SUBTITLE_CN.md滤镜与 GL 效果LUT 调色、美颜、Bloom、多 pass 模糊等见 RECENT_FEATURES.md投屏可选 gsyvideoplayer-cast 模块minSdk 26投屏后可按本地进度续播断开再无缝回本地Compose 接入Wrapper 一行嵌入或 Native 模式完全自绘控制层见 COMPOSE_USE.md。背景铺满模糊播放把播放器当页面背景用的常见形态播放不出来的时候常见报错与排查 ⚠️坑大多集中在下面四类官方问题集锦是标准答案册先翻它再搜索症状看哪里怎么处理混淆后 ClassNotFoundException、全屏崩溃反射规则未保留按 QUESTION.md 的规则保留 PlayerFactory/CacheFactory/播放器构造器别整包 keep找不到 so、加载失败ABI 不匹配检查 ndk abiFilters 与所选模块一致用 Analyze Apk 验证打包依赖拉不到Jitpack 历史丢包迁到 Maven Central11.0.0 起全屏/旋转时重建、自动停止manifest 配置缺失Activity 加 configChanges另一个习惯提 issue 前先在 demo 里复现并说明示例页面、视频流地址、机型与系统版本维护者定位会快很多。延伸快速上手doc/USE.md问题集锦大部分坑都在这里doc/QUESTION.md版本更新与迁移说明doc/UPDATE_VERSION.md13 个场景化接入 skillsskills/示例工程永远比文档跑得快拿不准就看 demo、再看源码接入基本就通了。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
