gsy-render-and-effects

三种渲染载体(TextureView / SurfaceView / GLSurfaceView)、显示比例(16:9/4:3/full/custom)、GL 滤镜与自定义 Shader。

SKILL.md

GitHub

gsy-render-and-effects

渲染类型 GSYVideoType.setRenderType(int)

常量 值 说明
TEXTURE 0 默认,与动画/圆角/缩放兼容最好
SURFACE 1 性能最好,但和 View 动画冲突
GLSURFACE 2 必需,若要用 setEffectFilter

见 GSYVideoType#L39-L49。设置时机:setUp 之前,全局生效。

显示比例 GSYVideoType.setShowType(int)

常量 值 说明
SCREEN_TYPE_DEFAULT 0 按视频原比例居中
SCREEN_TYPE_16_9 1 强制 16:9
SCREEN_TYPE_4_3 2 强制 4:3
SCREEN_TYPE_18_9 6 全面屏
SCREEN_TYPE_FULL 4 全屏裁减;surface_container 建议 FrameLayout
SCREEN_MATCH_FULL -4 全屏拉伸;surface_container 建议 FrameLayout
SCREEN_TYPE_CUSTOM -5 需先 setScreenScaleRatio(float)

见 GSYVideoType#L10-L29 与 GSYVideoType#L165-L167。

硬解码开关

静态方法 说明
enableMediaCodec() / disableMediaCodec() IJK 硬解码总开关 #L71-L79
enableMediaCodecTexture() / disableMediaCodecTexture() 硬解 + Texture 直渲染优化 #L100-L108
enableSmartMediaCodec() / disableSmartMediaCodec() 硬解失败自动软解回退 #L86-L94
isMediaCodec() / isMediaCodecTexture() / isSmartMediaCodec() 查询

设置时机:setUp 之前,且部分机型需要在 Application.onCreate 就配好。

GL 滤镜

需要满足两个条件:

  1. GSYVideoType.setRenderType(GSYVideoType.GLSURFACE)
  2. builder.setEffectFilter(new XxxEffect()) 或 player.setEffectFilter(...)

SDK 内置滤镜(在 com.shuyu.gsyvideoplayer.render.effect.*):AutoFixEffect、BarrelBlurEffect、BlackAndWhiteEffect、BrightnessEffect、ContrastEffect、CrossProcessEffect、DocumentaryEffect、DuotoneEffect、FillLightEffect、GammaEffect、GaussianBlurEffect、GrainEffect、GreyScaleEffect、HueEffect、InvertColorsEffect、LamoishEffect、NoEffect、OverlayEffect、PosterizeEffect、SampleBlurEffect、SaturationEffect、SepiaEffect、SharpnessEffect、TemperatureEffect、TintEffect、VignetteEffect。目录:render/effect。

自定义 Shader:实现 GSYVideoGLView.ShaderInterface。Demo 里 4 个复杂样例:GSYVideoGLViewCustomRender / 2 / 3 / 4,以及像素化 PixelationEffect、BitmapOverlay BitmapEffect / BitmapIconEffect。

v14.0.0 多 pass 与新效果

  • GSYVideoGLViewMultiPassRender + setMultiPassEffect + player.setCustomGLRenderer 接入 GaussianBlurMultiPassEffect / IterativeBlurPyramidEffect / BloomEffect。这些不是单 pass ShaderInterface 滤镜,不能直接传给 setEffectFilter。
  • LookupEffect(assetPath, intensity) / BeautyEffect(smoothLevel, whiteLevel) / GlitchEffect / CrtEffect / OldTvSignalEffect 使用 setEffectFilter。LUT 必须由使用方放入自己的 assets;Demo 的三张图不在播放器 AAR 中。
  • TextureShaderInterface 在 GL 线程管理额外纹理;动态效果使用渲染器按秒绑定的 uTime。
  • 显示比例变化后,传统 View 调 player.getCurrentPlayer().changeTextureViewShowType();Compose 调 controller.changeTextureViewShowType()。
  • 完整代码入口和实现文档见 RECENT_FEATURES.md。

抓帧 / gif / 截图

在 GSYRenderView:

方法 回调 说明
taskShotPic(GSYVideoShotListener) 返 Bitmap 单帧截图
saveFrame(File, GSYVideoShotSaveListener) 保存到磁盘 落盘截图
taskGifPic(...) + GifCreateHelper 生成 gif 见 GifCreateHelper

Demo 对照

常见坑

  • SurfaceView 在 RecyclerView 里滑动会撕裂 / 覆盖 → 列表用 TEXTURE。
  • GL 效果的性能取决于分辨率、pass 数和设备;先评估 pass/金字塔层数与实际帧率,不能通过静默换成 TextureView 宣称效果已生效。
  • 竖屏视频强制 SCREEN_TYPE_FULL 会大幅裁减;建议 SCREEN_TYPE_DEFAULT + setAutoFullWithSize(true)。