fix: improve pixel format selection for video output on iPhone 17

Author: nngb102

CHANGELOG.md

@@ -1,3 +1,7 @@
+### 7.1.4
+
+* [Apple] Fixed crash on iPhone 17 when starting MobileScanner by checking available pixel formats before setting video output settings. ([#1578](https://github.com/juliansteenbakker/mobile_scanner/issues/1578))
+
 ### 7.1.3
 
 * Overlay: Updated `BarcodePainter` to receive `deviceOrientation` and dynamically adjust `cameraPreviewSize`, fixing barcode overlay misalignment during device rotation changes [](https://github.com/juliansteenbakker/mobile_scanner/issues/1462).

darwin/mobile_scanner/Sources/mobile_scanner/MobileScannerPlugin.swift

@@ -455,53 +455,15 @@ public class MobileScannerPlugin: NSObject, FlutterPlugin, FlutterStreamHandler,
         }
         captureSession!.sessionPreset = AVCaptureSession.Preset.high
 
-        // Add video output
         let videoOutput = AVCaptureVideoDataOutput()
-        
-        // Fix for iPhone 17: Check available pixel formats before setting
-        // Issue: https://github.com/juliansteenbakker/mobile_scanner/issues/1578
-        
-        // Define preferred pixel formats in order of preference
-        let preferredFormats: [OSType] = [
-            kCVPixelFormatType_32BGRA,
-            kCVPixelFormatType_420YpCbCr8BiPlanarFullRange,
-            kCVPixelFormatType_420YpCbCr8BiPlanarVideoRange
-        ]
-        
-        // Get available formats and convert from NSNumber to OSType
-        let availableFormats = videoOutput.availableVideoPixelFormatTypes
-        let availablePixelFormats = availableFormats.compactMap { ($0 as NSNumber).uint32Value }
-        
-        // Find the first preferred format that is available
-        var selectedFormat: OSType?
-        for format in preferredFormats {
-            if availablePixelFormats.contains(format) {
-                selectedFormat = format
-                break
-            }
-        }
-        
-        // Fallback: use first available format if no preferred format found
-        if selectedFormat == nil, let firstAvailable = availablePixelFormats.first {
-            selectedFormat = firstAvailable
-        }
-        
-        // Apply the selected format or fallback to the old default
-        if let format = selectedFormat {
-            videoOutput.videoSettings = [kCVPixelBufferPixelFormatTypeKey as String: format]
-        } else {
-            // Ultimate fallback: use the original default format
-            videoOutput.videoSettings = [kCVPixelBufferPixelFormatTypeKey as String: kCVPixelFormatType_32BGRA]
-        }
-        
-        videoOutput.alwaysDiscardsLateVideoFrames = true
 
+        let format = getPreferredVideoFormat(videoOutput: videoOutput)
+        videoOutput.videoSettings = [kCVPixelBufferPixelFormatTypeKey as String: format]
+        videoOutput.alwaysDiscardsLateVideoFrames = true
         videoOutput.setSampleBufferDelegate(self, queue: DispatchQueue.main)
         captureSession!.addOutput(videoOutput)
         let deviceVideoOrientation = self.getVideoOrientation()
-        
 
-        // Adjust orientation for the video connection
         if let connection = videoOutput.connections.first {
             if connection.isVideoOrientationSupported {
                 connection.videoOrientation = deviceVideoOrientation
@@ -514,7 +476,6 @@ public class MobileScannerPlugin: NSObject, FlutterPlugin, FlutterStreamHandler,
 
         captureSession!.commitConfiguration()
 
-        // Move startRunning to a background thread to avoid blocking the main UI thread.
         DispatchQueue.global(qos: .background).async {
             self.captureSession!.startRunning()
 
@@ -527,12 +488,10 @@ public class MobileScannerPlugin: NSObject, FlutterPlugin, FlutterStreamHandler,
                     dimensions = CMVideoDimensions()
                 }
 
-                // Turn on the torch if requested.
                 if (torch) {
                     self.turnTorchOn()
                 }
 
-                // Set the initial zoom factor
                 if (initialZoom != nil) {
                     do {
                         try self.setScaleInternal(initialZoom!)
@@ -579,6 +538,34 @@ public class MobileScannerPlugin: NSObject, FlutterPlugin, FlutterStreamHandler,
         }
     }
 
+    /// Get the preferred video format for the given video output.
+    private func getPreferredVideoFormat(videoOutput: AVCaptureVideoDataOutput) -> OSType {
+        // Define preferred pixel formats in order of preference
+        let preferredFormats: [OSType] = [
+            kCVPixelFormatType_32BGRA,
+            kCVPixelFormatType_420YpCbCr8BiPlanarFullRange,
+            kCVPixelFormatType_420YpCbCr8BiPlanarVideoRange
+        ]
+        
+        // Get available formats and convert from NSNumber to OSType
+        let availableFormats = videoOutput.availableVideoPixelFormatTypes
+        let availablePixelFormats = availableFormats.compactMap { ($0 as NSNumber).uint32Value }
+        
+        // Find the first preferred format that is available
+        for format in preferredFormats {
+            if availablePixelFormats.contains(format) {
+                return format
+            }
+        }
+        
+        if let firstAvailable = availablePixelFormats.first {
+            return firstAvailable
+        }
+        
+        // Ultimate fallback: use the original default format
+        return kCVPixelFormatType_32BGRA
+    }
+
     /// Turn the torch on.
     private func turnTorchOn() {
         guard let device = self.device else {

pubspec.yaml

@@ -1,6 +1,6 @@
 name: mobile_scanner
 description: A universal Flutter barcode and QR code scanner using CameraX/ML Kit for Android, AVFoundation/Apple Vision for iOS & macOS, and ZXing for web.
-version: 7.1.3
+version: 7.1.4
 repository: https://github.com/juliansteenbakker/mobile_scanner
 
 screenshots: