gsy-kernel-switch

在 IJK / System / ExoPlayer2(Media3) / Aliyun 四个媒体内核之间自由切换,以及自定义 Manager 的方法。

SKILL.md

GitHub

gsy-kernel-switch

内核矩阵

Kernel Class 来源模块 特点
IJK(默认) IjkPlayerManager gsyVideoPlayer-java + 升级后的独立 ABI / ex_so FFmpeg n5.1.10 的固定配置;软/硬解能力按格式与设备确认
System SystemPlayerManager gsyVideoPlayer-java 无 so;靠 android.media.MediaPlayer;直播/复杂容器兼容差
Exo/Media3 GSYExoPlayerManager(Demo 内)/GSYExo2MediaPlayer gsyVideoPlayer-exo_player2 DASH / HLS / SmoothStreaming / TrackSelection
Aliyun AliPlayerManager gsyVideoPlayer-aliplay 阿里云 vid/authInfo;HLS 加密

切换 API

全局切换:PlayerFactory.setPlayManager(Class<? extends IPlayerManager>)(内部 getPlayManager 用 sPlayerManager.newInstance() 反射构造,故被切入的类必须有 public 无参构造)。见 PlayerFactory#L15-L27 与本仓库 R8 保留规则 proguard-rules.pro。

// Exo
PlayerFactory.setPlayManager(Exo2PlayerManager.class);
CacheFactory.setCacheManager(ExoPlayerCacheManager.class);

// System
PlayerFactory.setPlayManager(SystemPlayerManager.class);

// Aliyun
PlayerFactory.setPlayManager(AliPlayerManager.class);

必须在 player.setUp(...) 之前调用;否则本次实例仍用旧内核。

IPlayerManager 抽象

统一接口见 IPlayerManager。核心方法(子类必须实现):

方法 说明
initVideoPlayer(Context, Message, List<VideoOptionModel>, ICacheManager) 初始化内核;Message.obj 是 GSYModel
showDisplay(Message) 绑定 Surface / SurfaceHolder
setSpeed(float, boolean soundTouch) 速率 + 变速不变调
setNeedMute(boolean) 静音
setVolume(float, float) 双通道音量
getMediaPlayer() 底层 player 实例
isSurfaceSupportLockCanvas() 是否支持 lockCanvas(TextureView 补帧)
start / pause / stop / seekTo / release / getCurrentPosition / getDuration / getVideoSarNum / getVideoSarDen / getVideoWidth / getVideoHeight 基础控制

推荐继承 BasePlayerManager 以少写模板。

IPlayerInitSuccessListener hook

IPlayerInitSuccessListener 允许在 initVideoPlayer 完成后对底层 Player 拿手(比如设置 Exo 的 TrackSelector):

IjkPlayerManager.setIjkLibLoader(...);
// 或
GSYExoVideoManager.setPlayerInitSuccessListener(new IPlayerInitSuccessListener() {
    @Override public void onPlayerInitSuccess(IMediaPlayer mp, GSYModel model) { ... }
});

CacheFactory 同步切换

不同内核有各自缓存方案;切内核记得配套:

Player Manager 对应 CacheManager
IjkPlayerManager / SystemPlayerManager ProxyCacheManager(默认)
Exo/Media3 ExoPlayerCacheManager(gsyvideoplayer-exo_player2 内)
Aliyun 由 Aliyun SDK 自身管理,一般 CacheFactory 保持 ProxyCacheManager 或自定义空实现

多实例并行

用 CustomManager 模式:拷贝 GSYVideoManager 单例套壳,在自定义 GSYVideoView 里覆盖 getGSYVideoManager();不同页面互不影响,参考 MultiSampleVideo + ListMultiVideoActivity。

Demo 对照

v14.0.0 原生选择

IJK 当前三 ABI 成套库为 FFmpeg n5.1.10 / OpenSSL 3.5.9。GSYIjkMediaCodecSelector 先保留原 IJK 选择,再在 API 29+ 选择平台报告的普通 Codec2 硬件解码器,排除纯软件及安全/隧道必需解码器。这是初始化阶段的选择补充,与确认运行中硬解失败后重建软解的策略分开;见 发布说明。

常见坑

  • PlayerFactory.setPlayManager 传入的类必须有 public 无参构造,且被 ProGuard 保留。
  • Exo 切源建议用 Exo2PlayerManager + GSYExo2MediaPlayer;直接换 Manager 但用 Ijk 的 URL 会走缓存代理导致 DASH 解析失败——记得 setOverrideExtension("mpd") 或关闭缓存。
  • 系统内核 SystemPlayerManager 不支持 soundTouch、多数直播格式;生产环境仅作 fallback。