‌AndroidView 配置 TLHC（Texture Layer Hybrid Composition）模式指南

‌一、TLHC 核心原理‌

TLHC 是 Flutter 3.29+ 引入的 Hybrid Composition 优化模式，通过 ‌TextureView‌ 替代 ‌SurfaceView‌ 实现原生视图嵌入，减少内存拷贝并提升渲染性能‌57。其核心优势在于：

1. ‌单纹理共享‌：原生视图直接通过 SurfaceTexture 输出到 Flutter 的纹理层，避免双缓冲内存开销‌48。
2. ‌硬件加速兼容‌：支持与其他 Flutter Widgets 混合合成（如透明度、动画）‌56。

---

‌二、配置步骤与代码实现‌

‌1. Flutter 端配置‌

在 AndroidView 中启用 TLHC 模式：

dartCopy Code
AndroidView(
  viewType: 'native_texture_view',
  creationParams: {'key': 'value'},
  creationParamsCodec: StandardMessageCodec(),
  // 关键配置：启用 TLHC
  useTextureLayerHybridComposition: true, // ‌:ml-citation{ref="5,8" data="citationList"}
)

‌2. 原生端实现（Kotlin） ‌

需基于 TextureView 实现 PlatformView：

kotlinCopy Code
class NativeTextureView(context: Context, id: Int) : PlatformView {
    private val textureView = TextureView(context)

    init {
        textureView.surfaceTextureListener = object : TextureView.SurfaceTextureListener {
            override fun onSurfaceTextureAvailable(texture: SurfaceTexture, width: Int, height: Int) {
                // 初始化 OpenGL ES 或 Canvas 绘制逻辑（如视频解码）‌:ml-citation{ref="6,7" data="citationList"}
                val surface = Surface(texture)
                // 示例：绘制红色背景
                val canvas = surface.lockCanvas(null)
                canvas.drawColor(Color.RED)
                surface.unlockCanvasAndPost(canvas)
            }
            // 其他回调省略...
        }
    }

    override fun getView(): View = textureView // ‌:ml-citation{ref="5,8" data="citationList"}
}

‌3. 注册 PlatformView‌

在 FlutterEngine 初始化时注册视图工厂：

kotlinCopy Code
flutterEngine.platformViewsController.registry
    .registerViewFactory("native_texture_view", NativeTextureViewFactory())

---

‌三、关键配置要点‌

1. ‌版本要求‌

   • Flutter 3.29+ 强制要求启用 TLHC 以支持 Hybrid Composition++（HCPP）‌8。
   • 确保 Android 设备 API ≥ 14（TextureView 最低支持版本）‌15。

2. ‌透明背景处理‌
   若需透明背景，需同时在 Flutter 和原生端配置：

   dartCopy Code
   AndroidView(
     ...
     hitTestBehavior: PlatformViewHitTestBehavior.transparent, // Flutter 侧透明‌:ml-citation{ref="3" data="citationList"}
   )
   

   kotlinCopy Code
   // 原生端
   textureView.setBackgroundColor(Color.TRANSPARENT) // ‌:ml-citation{ref="3,8" data="citationList"}
   

3. ‌性能优化建议‌

   • ‌避免频繁更新‌：减少 SurfaceTexture 的 updateTexImage() 调用频率‌67。

   • ‌启用 HCPP‌：在 FlutterActivity 中强制启用 Hybrid Composition++：

     kotlinCopy Code
     FlutterImageView.enableHybridCompositionPlusPlus(true) // ‌:ml-citation{ref="8" data="citationList"}
     

---

‌四、与默认 Hybrid Composition 的对比‌

特性	‌TLHC 模式‌	‌默认 Hybrid Composition‌
‌内存占用‌	低（单纹理）	高（双缓冲 + 视图控制器）‌58
‌GPU 负载‌	低（无纹理拷贝）	高（需同步纹理到 Flutter）‌48
‌交互延迟‌	<5ms	10-20ms
‌适用场景‌	视频播放、动态地图	静态原生控件（如 WebView）

---

‌五、常见问题排查‌

1. ‌黑屏问题‌

   • 检查 SurfaceTextureListener 是否正确初始化绘制逻辑‌67。
   • 确认 TextureView 已设置透明背景且未被其他视图遮挡‌38。

2. ‌性能卡顿‌

   • 使用 Systrace 分析 SurfaceTexture 的更新频率，限制至 60Hz‌67。
   • 禁用非必要的视图层级属性（如圆角、阴影）‌45。

---

通过以上配置，可充分发挥 TLHC 模式的高性能优势，适用于高频渲染场景（如视频、游戏），同时保持与 Flutter UI 的无缝合成‌58。