星点匠心建站 星点匠心建站XD JIANXIN STUDIO
400-883-9527 免费定制方案
ARTICLE DETAIL

资讯详情

深耕新锐建站与运营推广的一线实战洞察。

Android 多内核视频播放接入指南:GSYVideoPlayer 从依赖到列表连播实战

Android 多内核视频播放接入指南:GSYVideoPlayer 从依赖到列表连播实战 Android 多内核视频播放接入指南GSYVideoPlayer 从依赖到列表连播实战【免费下载链接】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 和 MP4、要边播边缓存、要外挂字幕还得在 IJK、ExoPlayer、MediaPlayer 三个内核里切换又不想自己封装三套播放器GSYVideoPlayer 把 IJKPlayer、Media3ExoPlayer2、MediaPlayer、AliPlayer 四种内核统一在一套 UI 和 API 之下并内置边播边缓存、列表连播、SRT/WebVTT 字幕、弹幕和 GL 滤镜。本文面向第一次接入视频播放的 Android 开发者读完你会完成加依赖、播出一条流、切换内核这三件事。项目速览一句话说清它是什么GSYVideoPlayer 是一个开源 Android 视频播放器框架在 IJKPlayer、Media3ExoPlayer2、MediaPlayer、AliPlayer 四种内核之上提供统一的播放管理 API 和 UI切换播放引擎不用改业务代码。多内核切换PlayerFactory一行代码在 IJK、ExoPlayer、MediaPlayer、AliPlayer 之间切换格式兼容有兜底边播边缓存内置代理缓存MP4 网络流可边播边下Exo 模式换成 SimpleCache支持 HLS列表连播单例播放管理滑出屏幕自动释放信息流式列表可直接跑通跨内核字幕SRT/WebVTT 外挂字幕在 UI 层统一渲染IJK、Exo、MediaPlayer 三种内核通用GL 效果多 pass 高斯、金字塔模糊、Bloom、LUT 调色、美颜等滤镜开箱即用GSYVideoPlayer 采用分层架构内核、缓存、渲染层均可插拔替换快速上手从 0 到跑通加依赖三步播放第一个视频第一步添加 Maven Central 仓库与依赖。repositories { mavenCentral() } // module 级 build.gradle整包 Java Exo2 IJK 原生库 implementation io.github.carguo:gsyvideoplayer:14.0.0第二步布局加控件manifest 配置 Activity。com.shuyu.gsyvideoplayer.video.StandardGSYVideoPlayer android:idid/video_player android:layout_widthmatch_parent android:layout_height200dp /activity android:name.PlayActivity android:configChangeskeyboard|keyboardHidden|orientation|screenSize|screenLayout|smallestScreenSize|uiMode android:screenOrientationportrait /configChanges是全屏的硬性前提缺了它旋转屏幕会重建 Activity。第三步Activity 里调 setUp并绑定生命周期。videoPlayer findViewById(R.id.video_player); videoPlayer.setUp(url, true, 测试视频); videoPlayer.setCacheWithPlay(true); videoPlayer.startPlayLogic();// 分别在 onPause / onResume / onDestroy 中各调一行 videoPlayer.onVideoPause(); videoPlayer.onVideoResume(); GSYVideoManager.releaseAllVideos();跑通后你会看到播放区出现封面和控制条点按开始播放进度条随视频推进右上角全屏按钮可用。核心能力按使用场景讲边播边缓存弱网下长视频不卡顿流是较长的 MP4首遍播放不想干等缓冲重播又想秒开videoPlayer.setCacheWithPlay(true);流是 HLSm3u8时代理缓存不支持切到 Exo 的缓存PlayerFactory.setPlayManager(Exo2PlayerManager.class); CacheFactory.setCacheManager(new ExoPlayerCacheManager());收益已缓存片段走本地只有未缓存部分占用网络重播同一视频几乎秒开。列表里滑动即播今日头条式信息流信息流页面item 滑入屏幕自动播滑出去立即暂停释放。adapter 里用懒加载player.setUpLazy(url, true, null, null, 标题); player.setPlayTag(TAG); player.setPlayPosition(position);Activity 的滚动监听里判断正在播放的 item 是否滑出可视区int position GSYVideoManager.instance().getPlayPosition(); if (position firstVisibleItem || position lastVisibleItem) { GSYVideoManager.releaseAllVideos(); }收益GSYVideoManager 全局管理单例播放列表页有多个控件时任何时刻只有一个在真正解码内存占用小。一键切换内核换流不用改业务代码某个流当前内核放不了时不用改播放逻辑全局换内核// IJK 内核默认FFmpeg n5.1.10格式兼容最好 PlayerFactory.setPlayManager(IjkPlayerManager.class); // Exo 内核格式支持最多HLS/DASH 自适应清晰度 PlayerFactory.setPlayManager(Exo2PlayerManager.class); // 系统内核 MediaPlayer PlayerFactory.setPlayManager(SystemPlayerManager.class);收益同一 URL 在不同设备上行为不一致时可以先换内核兜底业务层代码零改动。进阶与避坑用 GSYVideoOptionBuilder 统一配置播放器列表 adapter 里参数多用 Builder 一次打包还能在多个控件间复用new GSYVideoOptionBuilder() .setUrl(url) .setThumbImageView(imageView) .setCacheWithPlay(true) .setVideoTitle(标题) .setShowFullAnimation(false) .setNeedLockFull(true) .build(videoPlayer);显示比例和渲染模式则是全局开关GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_16_9); GSYVideoType.setRenderType(GSYVideoType.GLSURFACE);给视频画面加 GL 滤镜用滤镜前先把渲染模式切到 GLSurfaceView再挂渲染器或效果GSYVideoType.setRenderType(GSYVideoType.GLSURFACE); GSYVideoGLViewMultiPassRender render new GSYVideoGLViewMultiPassRender(); render.setMultiPassEffect(new GaussianBlurMultiPassEffect(6.0f)); player.setCustomGLRenderer(render);Demo 里的背景模糊填充播放背景取自当前画面模糊后的版本LUT 调色、美颜、Bloom 等更多效果见 doc/RECENT_FEATURES.md。高频坑三行排查法混淆后 ClassNotFoundException现象debug 正常开 R8 后 release 包崩溃在 ClassNotFound 原因PlayerFactory、CacheFactory、全屏控件都靠反射构造实例R8 重命名了构造方法 解法按 doc/QUESTION.md 只保留三处反射点的 keep 规则不要整包保留so 加载错误现象日志报找不到 libijkplayer.so 或 dlopen 失败 原因v14 默认只提供 arm64-v8a / armeabi-v7a / x86_64 三个 ABI设备不在其中或同时引入了 ex_so 与独立 ABI 模块 解法abiFilters与所引模块对齐分模块引入时二者只选其一全屏旋转后播放器重置现象点全屏后页面重建播放进度和状态丢失 原因manifest 没配configChanges旋转触发了 Activity 重建 解法给播放页补上第二步里的configChangesHLS 缓存不生效现象m3u8 加了缓存每次仍重新下载文件 原因默认 ProxyCacheManager 是代理缓存只支持渐进式流 解法换 ExoPlayerCacheManager该模式仅配合 Exo 内核使用写在最后GSYVideoPlayer 适合“格式杂、要多内核、功能多”的视频业务列表连播、缓存、字幕、滤镜、全屏/小窗开箱即用遇到放不了的流可以换内核兜底。反过来如果你只播本地几个 MP4直接用 ExoPlayer 或 MediaPlayer 更轻量它的 Java 层加 IJK 原生库的依赖体积不小。下一步建议完整 API 与直接播放、列表、详情页三种最小用法在 doc/USE.md遇到问题先翻一遍问题集锦 doc/QUESTION.md大多数坑都有现成答案。【免费下载链接】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),仅供参考
返回列表