✨ lockCaptureOrientation (#68)

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

Author: TheVinhLuong

README-ZH.md

@@ -77,6 +77,7 @@ Flutter SDK：`>=2.0.0` 。
 | cameraQuarterTurns           | `int`                           | 摄像机视图顺时针旋转次数，每次 90 度                                | `0`                                    |
 | imageFormatGroup             | `ImageFormatGroup`              | 输出图像的格式描述                                                 | `ImageFormatGroup.unknown`             |
 | preferredLensDirection       | `CameraLensDirection`           | 首次使用相机时首选的镜头方向                                        | `CameraLensDirection.back`             |
+| lockCaptureOrientation       | `DeviceOrientation?`            | 摄像机在拍摄时锁定的旋转角度                                        | null                                   |
 | foregroundBuilder            | `Widget Function(CameraValue)?` | 覆盖在相机预览上方的前景构建                                        | null                                   |
 | onEntitySaving               | `EntitySaveCallback?`           | 在查看器中保存图片时的回调                                          | null                                   |
 | onError                      | `CameraErrorHandler?`           | 拍摄照片过程中的自定义错误处理                                      | null                                   |

README.md

@@ -78,6 +78,7 @@ Flutter SDK: `>=2.0.0` .
 | cameraQuarterTurns           | `int`                           | The number of clockwise quarter turns the camera view should be rotated.                              | `0`                                    |
 | imageFormatGroup             | `ImageFormatGroup`              | Describes the output of the raw image format.                                                         | `ImageFormatGroup.unknown`             |
 | preferredLensDirection       | `CameraLensDirection`           | Which lens direction is preferred when first using the camera.                                        | `CameraLensDirection.back`             |
+| lockCaptureOrientation       | `DeviceOrientation?`            | Whether the camera should be locked to the specific orientation during captures.                      | null                                   |
 | foregroundBuilder            | `Widget Function(CameraValue)?` | The foreground widget builder which will cover the whole camera preview.                              | null                                   |
 | onEntitySaving               | `EntitySaveCallback?`           | The callback type define for saving entity in the viewer.                                             | null                                   |
 | onError                      | `CameraErrorHandler?`           | The error handler when any error occurred during the picking process.                                 | null                                   |

lib/src/widgets/camera_picker.dart

@@ -49,6 +49,7 @@ class CameraPicker extends StatefulWidget {
     this.resolutionPreset = ResolutionPreset.max,
     this.imageFormatGroup = ImageFormatGroup.unknown,
     this.preferredLensDirection = CameraLensDirection.back,
+    this.lockCaptureOrientation,
     this.cameraQuarterTurns = 0,
     this.foregroundBuilder,
     this.onEntitySaving,
@@ -75,6 +76,11 @@ class CameraPicker extends StatefulWidget {
     }
   }
 
+  /// Whether the camera should be locked to the specific orientation
+  /// during captures.
+  /// 摄像机在拍摄时锁定的旋转角度
+  final DeviceOrientation? lockCaptureOrientation;
+
   /// The number of clockwise quarter turns the camera view should be rotated.
   /// 摄像机视图顺时针旋转次数，每次90度
   final int cameraQuarterTurns;
@@ -181,6 +187,7 @@ class CameraPicker extends StatefulWidget {
     ResolutionPreset resolutionPreset = ResolutionPreset.max,
     ImageFormatGroup imageFormatGroup = ImageFormatGroup.unknown,
     CameraLensDirection preferredLensDirection = CameraLensDirection.back,
+    DeviceOrientation? lockCaptureOrientation,
     Widget Function(CameraValue)? foregroundBuilder,
     EntitySaveCallback? onEntitySaving,
     CameraErrorHandler? onError,
@@ -212,6 +219,7 @@ class CameraPicker extends StatefulWidget {
           resolutionPreset: resolutionPreset,
           imageFormatGroup: imageFormatGroup,
           preferredLensDirection: preferredLensDirection,
+          lockCaptureOrientation: lockCaptureOrientation,
           foregroundBuilder: foregroundBuilder,
           onEntitySaving: onEntitySaving,
           onError: onError,
@@ -571,10 +579,13 @@ class CameraPickerState extends State<CameraPicker>
 
       try {
         await controller.initialize();
+        // Call recording preparation first.
         if (shouldPrepareForVideoRecording) {
           await controller.prepareForVideoRecording();
         }
+        // Then call other asynchronous methods.
         Future.wait(<Future<void>>[
+          controller.lockCaptureOrientation(widget.lockCaptureOrientation),
           (() async => _maxAvailableExposureOffset =
               await controller.getMaxExposureOffset())(),
           (() async => _minAvailableExposureOffset =