feat(barcode-scanning): pause and resume scan feature, cap 7

packages/barcode-scanning/.gitignore

@@ -1,5 +1,4 @@
 # node files
-dist
 node_modules
 
 # iOS files

packages/barcode-scanning/README.md

@@ -308,6 +308,8 @@ If you can't see the camera view, make sure all elements in the DOM are not visi
 
 * [`startScan(...)`](#startscan)
 * [`stopScan()`](#stopscan)
+* [`pauseScan()`](#pausescan)
+* [`resumeScan()`](#resumescan)
 * [`readBarcodesFromImage(...)`](#readbarcodesfromimage)
 * [`scan(...)`](#scan)
 * [`isSupported()`](#issupported)
@@ -368,6 +370,32 @@ Stop scanning for barcodes.
 --------------------
 
 
+### pauseScan()
+
+```typescript
+pauseScan() => Promise<void>
+```
+
+Pause scanning for barcodes.
+
+**Since:** 8.1.0
+
+--------------------
+
+
+### resumeScan()
+
+```typescript
+resumeScan() => Promise<void>
+```
+
+Resume scanning for barcodes.
+
+**Since:** 8.1.0
+
+--------------------
+
+
 ### readBarcodesFromImage(...)
 
 ```typescript

packages/barcode-scanning/android/src/main/java/io/capawesome/capacitorjs/plugins/mlkit/barcodescanning/BarcodeScanner.java

@@ -80,6 +80,8 @@ public class BarcodeScanner implements ImageAnalysis.Analyzer {
 
     private boolean isTorchEnabled = false;
 
+    private boolean isPaused = false;
+
     public BarcodeScanner(BarcodeScannerPlugin plugin) {
         this.plugin = plugin;
     }
@@ -177,9 +179,54 @@ public void stopScan() {
         }
         barcodeScannerInstance = null;
         scanSettings = null;
+        isPaused = false;
         barcodeRawValueVotes.clear();
     }
 
+    /**
+     * Must run on UI thread.
+     */
+    public void pauseScan() {
+        isPaused = true;
+        if (processCameraProvider != null) {
+            processCameraProvider.unbindAll();
+        }
+    }
+
+    /**
+     * Must run on UI thread.
+     */
+    public void resumeScan() {
+        if (!isPaused || scanSettings == null || processCameraProvider == null) {
+            return;
+        }
+
+        isPaused = false;
+
+        try {
+            ImageAnalysis imageAnalysis = new ImageAnalysis.Builder()
+                .setBackpressureStrategy(ImageAnalysis.STRATEGY_KEEP_ONLY_LATEST)
+                .setTargetResolution(scanSettings.resolution)
+                .build();
+            imageAnalysis.setAnalyzer(ContextCompat.getMainExecutor(plugin.getContext()), this);
+
+            CameraSelector cameraSelector = new CameraSelector.Builder().requireLensFacing(scanSettings.lensFacing).build();
+
+            Preview preview = new Preview.Builder().build();
+            if (previewView != null) {
+                preview.setSurfaceProvider(previewView.getSurfaceProvider());
+            }
+
+            camera = processCameraProvider.bindToLifecycle((LifecycleOwner) plugin.getContext(), cameraSelector, preview, imageAnalysis);
+
+            if (isTorchEnabled && camera != null) {
+                camera.getCameraControl().enableTorch(true);
+            }
+        } catch (Exception exception) {
+            handleScanError(exception);
+        }
+    }
+
     public void readBarcodesFromImage(String path, ScanSettings scanSettings, ReadBarcodesFromImageResultCallback callback)
         throws Exception {
         InputImage inputImage;
@@ -354,6 +401,11 @@ public boolean isCameraActive() {
 
     @Override
     public void analyze(@NonNull ImageProxy imageProxy) {
+        if (isPaused) {
+            imageProxy.close();
+            return;
+        }
+
         @SuppressLint("UnsafeOptInUsageError")
         Image image = imageProxy.getImage();
 

packages/barcode-scanning/android/src/main/java/io/capawesome/capacitorjs/plugins/mlkit/barcodescanning/BarcodeScannerPlugin.java

@@ -122,6 +122,34 @@ public void stopScan(PluginCall call) {
         }
     }
 
+    @PluginMethod
+    public void pauseScan(PluginCall call) {
+        try {
+            getActivity()
+                .runOnUiThread(() -> {
+                    implementation.pauseScan();
+                    call.resolve();
+                });
+        } catch (Exception exception) {
+            Logger.error(TAG, exception.getMessage(), exception);
+            call.reject(exception.getMessage());
+        }
+    }
+
+    @PluginMethod
+    public void resumeScan(PluginCall call) {
+        try {
+            getActivity()
+                .runOnUiThread(() -> {
+                    implementation.resumeScan();
+                    call.resolve();
+                });
+        } catch (Exception exception) {
+            Logger.error(TAG, exception.getMessage(), exception);
+            call.reject(exception.getMessage());
+        }
+    }
+
     @PluginMethod
     public void readBarcodesFromImage(PluginCall call) {
         try {