如何将Unity场景集成到Jetpack Compose的Composable组件中？

核心实现逻辑 #

Unity对Android生命周期依赖极强，直接将UnityPlayer放入AndroidView会导致生命周期不匹配，所以关键是把UnityPlayer的生命周期和Composable、宿主Activity的生命周期严格绑定，具体步骤如下：

1. 缓存UnityPlayer实例 #

用remember缓存UnityPlayer对象，避免Composable重建时重复初始化Unity，减少性能损耗和资源泄漏：

val unityPlayer = remember { UnityPlayer(context) }

2. 通过AndroidView嵌入UnityPlayer #

用Compose的AndroidView组件承载UnityPlayer，这是原生View和Compose交互的标准方式：

AndroidView(
    factory = { unityPlayer },
    update = { player ->
        // 可在此处理UnityPlayer的动态更新逻辑，比如调整尺寸、设置回调
    }
)

3. 绑定生命周期回调 #

利用DisposableEffect监听Compose和宿主Activity的生命周期，同步调用UnityPlayer对应的方法：

// 处理Composable自身的创建/销毁
DisposableEffect(unityPlayer) {
    unityPlayer.requestFocus()
    onDispose {
        // 销毁Composable时彻底释放Unity资源
        unityPlayer.quit()
    }
}

// 绑定宿主Activity的生命周期
val lifecycleOwner = LocalLifecycleOwner.current
DisposableEffect(lifecycleOwner) {
    val observer = LifecycleEventObserver { _, event ->
        when (event) {
            Lifecycle.Event.ON_RESUME -> unityPlayer.resume()
            Lifecycle.Event.ON_PAUSE -> unityPlayer.pause()
            Lifecycle.Event.ON_STOP -> unityPlayer.stop()
            Lifecycle.Event.ON_DESTROY -> unityPlayer.destroy()
            else -> {}
        }
    }
    lifecycleOwner.lifecycle.addObserver(observer)

    onDispose {
        lifecycleOwner.lifecycle.removeObserver(observer)
    }
}

关键注意事项 #

• 确保Unity Android项目配置正确：包括Manifest中的权限、Unity相关meta-data、NDK配置等（如果之前已经在Activity中成功运行过Unity，这部分无需改动）
• 避免频繁重建UnityPlayer：除非业务需要，否则不要在Composable中重新创建实例，用remember保持状态
• 交互逻辑实现：如果需要Compose和Unity双向通信，可通过UnityPlayer的SendMessage方法调用Unity侧方法，或在Unity中通过AndroidJavaClass调用Android侧逻辑
• 内存泄漏检测：测试时用Android Studio的Profiler检查内存情况，确保UnityPlayer在Composable销毁后被完全释放

内容的提问来源于stack exchange，提问作者Scott Susman