✨ CameraPickerConfig.preferredFlashMode (#158)

Co-authored-by: Alex Li <[email protected]>

Author: leftcoding

CHANGELOG.md

@@ -6,6 +6,10 @@ that can be found in the LICENSE file. -->
 
 ## 3.7.0
 
+### New features
+
+- Add `preferredFlashMode`, allowing users to choose which flash mode is preferred when first using the camera. (#158)
+
 ### Improvements
 
 - Allow flash modes failed to switch and can move on to next when switching. (#156)

lib/src/constants/config.dart

@@ -33,6 +33,7 @@ class CameraPickerConfig {
     this.resolutionPreset = ResolutionPreset.max,
     this.imageFormatGroup = ImageFormatGroup.unknown,
     this.preferredLensDirection = CameraLensDirection.back,
+    this.preferredFlashMode = FlashMode.auto,
     this.lockCaptureOrientation,
     this.foregroundBuilder,
     this.previewTransformBuilder,
@@ -138,6 +139,11 @@ class CameraPickerConfig {
   /// 摄像机在拍摄时锁定的旋转角度
   final DeviceOrientation? lockCaptureOrientation;
 
+  /// Which flash mode is preferred when first using the camera,
+  /// typically with the auto mode.
+  /// 首次使用相机时首选的闪光灯，通常是自动模式。
+  final FlashMode preferredFlashMode;
+
   /// {@macro wechat_camera_picker.EntitySaveCallback}
   final EntitySaveCallback? onEntitySaving;
 

lib/src/states/camera_picker_state.dart

@@ -337,6 +337,8 @@ class CameraPickerState extends State<CameraPicker>
             newController
                 .getMinZoomLevel()
                 .then((double value) => minAvailableZoom = value),
+            if (pickerConfig.preferredFlashMode != FlashMode.auto)
+              newController.setFlashMode(pickerConfig.preferredFlashMode),
           ],
           eagerError: true,
         );