react-native-rectangle-doc-scanner 3.170.0 → 3.172.0

package/android/src/main/kotlin/com/reactnativerectangledocscanner/CameraController.kt

@@ -141,15 +141,10 @@ class CameraController(
         }
 
         try {
-            // Set surface provider BEFORE binding to lifecycle
-            Log.d(TAG, "[BIND] Setting surface provider to previewView...")
             Log.d(TAG, "[BIND] PreviewView: $previewView")
             Log.d(TAG, "[BIND] PreviewView.surfaceProvider: ${previewView.surfaceProvider}")
             Log.d(TAG, "[BIND] PreviewView attached to window: ${previewView.isAttachedToWindow}")
             Log.d(TAG, "[BIND] PreviewView size: ${previewView.width}x${previewView.height}")
-            preview.setSurfaceProvider(previewView.surfaceProvider)
-            Log.d(TAG, "[BIND] Surface provider set successfully")
-
             // Unbind all use cases before rebinding
             Log.d(TAG, "[BIND] Unbinding all existing use cases...")
             cameraProvider.unbindAll()
@@ -169,6 +164,14 @@ class CameraController(
             )
             Log.d(TAG, "[BIND] Bound to lifecycle successfully, camera: $camera")
 
+            Log.d(TAG, "[BIND] Setting surface provider to previewView...")
+            Log.d(TAG, "[BIND] PreviewView: $previewView")
+            Log.d(TAG, "[BIND] PreviewView.surfaceProvider: ${previewView.surfaceProvider}")
+            // Devices with the SurfaceOrderQuirk expect the preview surface to be set last.
+            // Apply the SurfaceProvider after binding so the preview stays on top.
+            preview.setSurfaceProvider(previewView.surfaceProvider)
+            Log.d(TAG, "[BIND] Surface provider set successfully")
+
             // Restore torch state if it was enabled
             if (torchEnabled) {
                 Log.d(TAG, "[BIND] Restoring torch state...")

package/android/src/main/kotlin/com/reactnativerectangledocscanner/DocumentScannerView.kt

@@ -77,13 +77,12 @@ class DocumentScannerView(context: ThemedReactContext) : FrameLayout(context), L
         previewView = PreviewView(context).apply {
             layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT)
             scaleType = PreviewView.ScaleType.FILL_CENTER
-            // Use PERFORMANCE mode (SurfaceView) for better performance
+            // SurfaceView backed preview avoids black frames on some MediaTek devices
             implementationMode = PreviewView.ImplementationMode.PERFORMANCE
-            // Force visibility to ensure the view is rendered
             visibility = View.VISIBLE
-            // Keep the screen on while preview is active
             keepScreenOn = true
-            // Request layout to ensure proper sizing
+            // Ensure the preview stays behind overlays even if SurfaceFlinger reorders surfaces
+            setZOrderOnTop(false)
             requestLayout()
         }
         Log.d(TAG, "[INIT] PreviewView created: $previewView")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-rectangle-doc-scanner",
-  "version": "3.170.0",
+  "version": "3.172.0",
   "description": "Native-backed document scanner for React Native with customizable overlays.",
   "license": "MIT",
   "main": "dist/index.js",