@dolami-inc/react-native-expo-unity 0.4.5 → 0.5.0

package/android/src/main/java/expo/modules/unity/ExpoUnityView.kt

@@ -2,8 +2,6 @@ package expo.modules.unity
 
 import android.content.Context
 import android.util.Log
-import android.view.ViewGroup
-import android.widget.FrameLayout
 import expo.modules.kotlin.AppContext
 import expo.modules.kotlin.viewevent.EventDispatcher
 import expo.modules.kotlin.views.ExpoView
@@ -29,47 +27,32 @@ class ExpoUnityView(context: Context, appContext: AppContext) : ExpoView(context
 
         val bridge = UnityBridge.getInstance()
 
-        if (!bridge.isInitialized) {
-            bridge.initialize(activity)
-        }
-
         bridge.onMessage = { message ->
             post {
                 onUnityMessage(mapOf("message" to message))
             }
         }
 
-        mountUnityView()
-    }
-
-    private fun mountUnityView() {
-        val playerView = UnityBridge.getInstance().unityPlayerView ?: run {
-            Log.w(TAG, "Unity player view not available yet")
-            return
+        if (bridge.isReady) {
+            // Unity already initialized — just reparent the view into this container
+            bridge.addUnityViewToGroup(this)
+            Log.i(TAG, "Unity already ready, reparented view")
+        } else {
+            // Initialize Unity with a callback that reparents when ready
+            bridge.initialize(activity) {
+                post {
+                    bridge.addUnityViewToGroup(this)
+                    Log.i(TAG, "Unity ready, view reparented into container")
+                }
+            }
         }
-
-        // Remove from previous parent if needed
-        (playerView.parent as? ViewGroup)?.removeView(playerView)
-
-        addView(
-            playerView,
-            FrameLayout.LayoutParams(
-                FrameLayout.LayoutParams.MATCH_PARENT,
-                FrameLayout.LayoutParams.MATCH_PARENT
-            )
-        )
-
-        Log.i(TAG, "Unity view mounted")
     }
 
-    override fun onAttachedToWindow() {
-        super.onAttachedToWindow()
-        // Start rendering after the view is in the window hierarchy,
-        // so Unity's surface is properly connected to the display.
+    override fun onWindowFocusChanged(hasWindowFocus: Boolean) {
+        super.onWindowFocusChanged(hasWindowFocus)
         val bridge = UnityBridge.getInstance()
-        if (bridge.isInitialized) {
-            bridge.startRendering()
-        }
+        if (!bridge.isReady) return
+        bridge.unityPlayer?.windowFocusChanged(hasWindowFocus)
     }
 
     override fun onDetachedFromWindow() {
@@ -81,8 +64,10 @@ class ExpoUnityView(context: Context, appContext: AppContext) : ExpoView(context
                 bridge.unload()
                 Log.i(TAG, "Auto-unloaded (view detached)")
             } else {
+                // Park Unity in the background instead of unloading
+                bridge.parkUnityViewInBackground()
                 bridge.setPaused(true)
-                Log.i(TAG, "Auto-paused on unmount (autoUnloadOnUnmount=false)")
+                Log.i(TAG, "Parked in background (autoUnloadOnUnmount=false)")
             }
         }
 

package/android/src/main/java/expo/modules/unity/UnityBridge.kt

@@ -1,10 +1,14 @@
 package expo.modules.unity
 
 import android.app.Activity
+import android.graphics.PixelFormat
 import android.os.Handler
 import android.os.Looper
 import android.util.Log
 import android.view.View
+import android.view.ViewGroup
+import android.view.WindowManager
+import android.widget.FrameLayout
 import com.expounity.bridge.NativeCallProxy
 import com.unity3d.player.IUnityPlayerLifecycleEvents
 import com.unity3d.player.UnityPlayer
@@ -14,8 +18,10 @@ import com.unity3d.player.UnityPlayerForActivityOrService
  * Singleton managing the UnityPlayer lifecycle.
  * Android equivalent of ios/UnityBridge.mm.
  *
- * Uses UnityPlayerForActivityOrService which manages its own rendering
- * surface internally — suitable for UaaL (Unity as a Library) embedding.
+ * Uses a "background parking" pattern: Unity is always attached to the
+ * Activity's content view (at 1x1px, Z=-1) so it stays alive. When a
+ * React Native view wants to show Unity, we reparent the FrameLayout
+ * into that view. When it unmounts, we park it back in the background.
  */
 class UnityBridge private constructor() : IUnityPlayerLifecycleEvents, NativeCallProxy.MessageListener {
 
@@ -43,6 +49,9 @@ class UnityBridge private constructor() : IUnityPlayerLifecycleEvents, NativeCal
     /** Tracked here (not on the Module) so it survives module recreation. */
     var wasRunningBeforeBackground: Boolean = false
 
+    var isReady: Boolean = false
+        private set
+
     val isInitialized: Boolean
         get() = unityPlayer != null
 
@@ -50,20 +59,51 @@ class UnityBridge private constructor() : IUnityPlayerLifecycleEvents, NativeCal
      * Returns the UnityPlayer's FrameLayout for embedding.
      * UnityPlayerForActivityOrService creates its own rendering surface internally.
      */
-    val unityPlayerView: View?
+    val unityPlayerView: FrameLayout?
         get() = unityPlayer?.frameLayout
 
-    fun initialize(activity: Activity) {
-        if (isInitialized) return
+    fun initialize(activity: Activity, onReady: (() -> Unit)? = null) {
+        if (isInitialized) {
+            onReady?.invoke()
+            return
+        }
 
         val runInit = Runnable {
             try {
+                // Set RGBA_8888 format for proper rendering
+                activity.window.setFormat(PixelFormat.RGBA_8888)
+
+                // Save fullscreen state before Unity potentially changes it
+                val flags = activity.window.attributes.flags
+                val wasFullScreen = (flags and WindowManager.LayoutParams.FLAG_FULLSCREEN) != 0
+
                 val player = UnityPlayerForActivityOrService(activity, this)
                 unityPlayer = player
 
                 NativeCallProxy.registerListener(this)
+                Log.i(TAG, "Unity player created")
+
+                // Give Unity time to initialize its rendering pipeline
+                Thread.sleep(1000)
+
+                // Park the Unity view in the background (1x1px, behind everything)
+                addUnityViewToBackground(activity)
+
+                // Kick-start rendering
+                player.windowFocusChanged(true)
+                player.frameLayout?.requestFocus()
+                player.resume()
 
-                Log.i(TAG, "Unity initialized")
+                // Restore fullscreen state if Unity changed it
+                if (!wasFullScreen) {
+                    activity.window.addFlags(WindowManager.LayoutParams.FLAG_FORCE_NOT_FULLSCREEN)
+                    activity.window.clearFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN)
+                }
+
+                isReady = true
+                Log.i(TAG, "Unity initialized and ready")
+
+                onReady?.invoke()
             } catch (e: Exception) {
                 Log.e(TAG, "Failed to initialize Unity", e)
             }
@@ -77,14 +117,67 @@ class UnityBridge private constructor() : IUnityPlayerLifecycleEvents, NativeCal
     }
 
     /**
-     * Must be called after the Unity view is attached to the window hierarchy.
-     * Triggers Unity's rendering pipeline.
+     * Parks the Unity view in the Activity's content view at 1x1 pixels
+     * behind all other views (Z=-1). This keeps Unity alive but invisible.
+     */
+    private fun addUnityViewToBackground(activity: Activity) {
+        val frame = unityPlayerView ?: return
+
+        // Remove from current parent if any
+        (frame.parent as? ViewGroup)?.let { parent ->
+            parent.endViewTransition(frame)
+            parent.removeView(frame)
+        }
+
+        frame.z = -1f
+
+        val layoutParams = ViewGroup.LayoutParams(1, 1)
+        activity.addContentView(frame, layoutParams)
+        Log.i(TAG, "Unity view parked in background")
+    }
+
+    /**
+     * Moves the Unity view from wherever it currently is into the
+     * specified ViewGroup with MATCH_PARENT layout. Called when the
+     * React Native component mounts.
      */
-    fun startRendering() {
-        val player = unityPlayer ?: return
-        player.resume()
-        player.windowFocusChanged(true)
-        Log.i(TAG, "Rendering started")
+    fun addUnityViewToGroup(group: ViewGroup) {
+        val frame = unityPlayerView ?: return
+
+        // Remove from current parent
+        (frame.parent as? ViewGroup)?.removeView(frame)
+
+        val layoutParams = ViewGroup.LayoutParams(
+            ViewGroup.LayoutParams.MATCH_PARENT,
+            ViewGroup.LayoutParams.MATCH_PARENT
+        )
+        group.addView(frame, 0, layoutParams)
+
+        unityPlayer?.windowFocusChanged(true)
+        frame.requestFocus()
+        unityPlayer?.resume()
+
+        Log.i(TAG, "Unity view moved to visible container")
+    }
+
+    /**
+     * Parks the Unity view back to the background. Called when the
+     * React Native component unmounts.
+     */
+    fun parkUnityViewInBackground() {
+        val frame = unityPlayerView ?: return
+        val activity = frame.context as? Activity ?: return
+
+        (frame.parent as? ViewGroup)?.let { parent ->
+            parent.endViewTransition(frame)
+            parent.removeView(frame)
+        }
+
+        frame.z = -1f
+
+        val layoutParams = ViewGroup.LayoutParams(1, 1)
+        activity.addContentView(frame, layoutParams)
+        Log.i(TAG, "Unity view parked back to background")
     }
 
     fun sendMessage(gameObject: String, methodName: String, message: String) {
@@ -110,6 +203,7 @@ class UnityBridge private constructor() : IUnityPlayerLifecycleEvents, NativeCal
 
     fun unload() {
         if (!isInitialized) return
+        isReady = false
         Log.i(TAG, "unload called")
         val action = Runnable {
             unityPlayer?.unload()
@@ -127,11 +221,13 @@ class UnityBridge private constructor() : IUnityPlayerLifecycleEvents, NativeCal
     override fun onUnityPlayerUnloaded() {
         Log.i(TAG, "onUnityPlayerUnloaded")
         unityPlayer = null
+        isReady = false
     }
 
     override fun onUnityPlayerQuitted() {
         Log.i(TAG, "onUnityPlayerQuitted")
         unityPlayer = null
+        isReady = false
     }
 
     // NativeCallProxy.MessageListener (Unity -> RN)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dolami-inc/react-native-expo-unity",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "description": "Unity as a Library (UaaL) bridge for React Native / Expo",
   "main": "src/index.ts",
   "types": "src/index.ts",