carguo gsy-kernel-switch
内核矩阵
| Kernel | Class | 来源模块 | 特点 |
|---|---|---|---|
| IJK（默认） | IjkPlayerManager | gsyVideoPlayer-java + armv*/ex_so |
ffmpeg 全格式；so ~15 MB/ABI；软/硬解双通道 |
| 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 对照
- Exo 切源 / 无缝切换：DetailExoListPlayer、ExoAdaptiveTrackActivity
- MediaCodec 智能回退：SmartMediaCodecFallbackActivity + doc/SMART_MEDIACODEC_FALLBACK_RESEARCH.md
常见坑
PlayerFactory.setPlayManager传入的类必须有public无参构造，且被 ProGuard 保留。- Exo 切源建议用
Exo2PlayerManager+GSYExo2MediaPlayer；直接换 Manager 但用 Ijk 的 URL 会走缓存代理导致 DASH 解析失败——记得setOverrideExtension("mpd")或关闭缓存。 - 系统内核
SystemPlayerManager不支持soundTouch、多数直播格式；生产环境仅作 fallback。