✨ shouldAutoPreviewVideo (#59)

Author: AlexV525

README-ZH.md

@@ -69,6 +69,7 @@ Flutter SDK：`>=2.0.0` 。
 | enablePinchToZoom            | `bool`                          | 用户是否可以在界面上双指缩放相机对焦                                | `true`                                 |
 | enablePullToZoomInRecord     | `bool`                          | 用户是否可以在录制视频时上拉缩放                                    | `true`                                 |
 | shouldDeletePreviewFile      | `bool`                          | 返回页面时是否删除预览文件                                         | `false`                                |
+| shouldAutoPreviewVideo       | `bool`                          | 在预览时是否直接播放视频                                           | `false`                                |
 | maximumRecordingDuration     | `Duration`                      | 录制视频最长时长                                                  | `const Duration(seconds: 15)`          |
 | theme                        | `ThemeData?`                    | 选择器的主题                                                     | `CameraPicker.themeData(C.themeColor)` |
 | textDelegate                 | `CameraPickerTextDelegate?`     | 控制部件中的文字实现                                              | `DefaultCameraPickerTextDelegate`      |

README.md

@@ -70,6 +70,7 @@ Flutter SDK: `>=2.0.0` .
 | enablePinchToZoom            | `bool`                          | Whether users can zoom the camera by pinch.                                                           | `true`                                 |
 | enablePullToZoomInRecord     | `bool`                          | Whether users can zoom by pulling up when recording video.                                            | `true`                                 |
 | shouldDeletePreviewFile      | `bool`                          | Whether the preview file will be delete when pop.                                                     | `false`                                |
+| shouldAutoPreviewVideo       | `bool`                          | Whether the video should be played instantly in the preview.                                          | `false`                                |
 | maximumRecordingDuration     | `Duration`                      | The maximum duration of the video recording process.                                                  | `const Duration(seconds: 15)`          |
 | theme                        | `ThemeData?`                    | Theme data for the picker.                                                                            | `CameraPicker.themeData(C.themeColor)` |
 | textDelegate                 | `CameraPickerTextDelegate?`     | Text delegate that controls text in widgets.                                                          | `DefaultCameraPickerTextDelegate`      |

lib/src/widgets/camera_picker.dart

@@ -43,6 +43,7 @@ class CameraPicker extends StatefulWidget {
     this.enablePinchToZoom = true,
     this.enablePullToZoomInRecord = true,
     this.shouldDeletePreviewFile = false,
+    this.shouldAutoPreviewVideo = false,
     this.maximumRecordingDuration = const Duration(seconds: 15),
     this.theme,
     this.resolutionPreset = ResolutionPreset.max,
@@ -113,10 +114,18 @@ class CameraPicker extends StatefulWidget {
   /// 用户是否可以在录制视频时上拉缩放
   final bool enablePullToZoomInRecord;
 
+  /// {@template wechat_camera_picker.shouldDeletePreviewFile}
   /// Whether the preview file will be delete when pop.
   /// 返回页面时是否删除预览文件
+  /// {@endtemplate}
   final bool shouldDeletePreviewFile;
 
+  /// {@template wechat_camera_picker.shouldAutoPreviewVideo}
+  /// Whether the video should be played instantly in the preview.
+  /// 在预览时是否直接播放视频
+  /// {@endtemplate}
+  final bool shouldAutoPreviewVideo;
+
   /// The maximum duration of the video recording process.
   /// 录制视频最长时长
   ///
@@ -164,6 +173,7 @@ class CameraPicker extends StatefulWidget {
     bool enablePinchToZoom = true,
     bool enablePullToZoomInRecord = true,
     bool shouldDeletePreviewFile = false,
+    bool shouldAutoPreviewVideo = false,
     Duration maximumRecordingDuration = const Duration(seconds: 15),
     ThemeData? theme,
     int cameraQuarterTurns = 0,
@@ -194,6 +204,7 @@ class CameraPicker extends StatefulWidget {
           enablePinchToZoom: enablePinchToZoom,
           enablePullToZoomInRecord: enablePullToZoomInRecord,
           shouldDeletePreviewFile: shouldDeletePreviewFile,
+          shouldAutoPreviewVideo: shouldAutoPreviewVideo,
           maximumRecordingDuration: maximumRecordingDuration,
           theme: theme,
           cameraQuarterTurns: cameraQuarterTurns,
@@ -386,6 +397,8 @@ class CameraPickerState extends State<CameraPicker>
 
   bool get shouldDeletePreviewFile => widget.shouldDeletePreviewFile;
 
+  bool get shouldAutoPreviewVideo => widget.shouldAutoPreviewVideo;
+
   Duration? get maximumRecordingDuration => widget.maximumRecordingDuration;
 
   /// Whether the recording restricted to a specific duration.
@@ -769,6 +782,7 @@ class CameraPickerState extends State<CameraPicker>
         previewXFile: _file,
         theme: theme,
         shouldDeletePreviewFile: shouldDeletePreviewFile,
+        shouldAutoPreviewVideo: shouldAutoPreviewVideo,
         onEntitySaving: widget.onEntitySaving,
       );
       if (entity != null) {
@@ -862,6 +876,7 @@ class CameraPickerState extends State<CameraPicker>
           previewXFile: file,
           theme: theme,
           shouldDeletePreviewFile: shouldDeletePreviewFile,
+          shouldAutoPreviewVideo: shouldAutoPreviewVideo,
         );
         if (entity != null) {
           Navigator.of(context).pop(entity);

lib/src/widgets/camera_picker_viewer.dart

@@ -27,6 +27,7 @@ class CameraPickerViewer extends StatefulWidget {
     required this.previewXFile,
     required this.theme,
     this.shouldDeletePreviewFile = false,
+    this.shouldAutoPreviewVideo = false,
     this.onEntitySaving,
     this.onError,
   }) : super(key: key);
@@ -47,10 +48,12 @@ class CameraPickerViewer extends StatefulWidget {
   /// 选择器使用的主题
   final ThemeData theme;
 
-  /// Whether the preview file will be delete when pop.
-  /// 返回页面时是否删除预览文件
+  /// {@macro wechat_camera_picker.shouldDeletePreviewFile}
   final bool shouldDeletePreviewFile;
 
+  /// {@macro wechat_camera_picker.shouldAutoPreviewVideo}
+  final bool shouldAutoPreviewVideo;
+
   /// {@macro wechat_camera_picker.EntitySaveCallback}
   final EntitySaveCallback? onEntitySaving;
 
@@ -66,6 +69,7 @@ class CameraPickerViewer extends StatefulWidget {
     required XFile previewXFile,
     required ThemeData theme,
     bool shouldDeletePreviewFile = false,
+    bool shouldAutoPreviewVideo = false,
     EntitySaveCallback? onEntitySaving,
     CameraErrorHandler? onError,
   }) {
@@ -77,6 +81,7 @@ class CameraPickerViewer extends StatefulWidget {
           previewXFile: previewXFile,
           theme: theme,
           shouldDeletePreviewFile: shouldDeletePreviewFile,
+          shouldAutoPreviewVideo: shouldAutoPreviewVideo,
           onEntitySaving: onEntitySaving,
           onError: onError,
         ),
@@ -132,6 +137,8 @@ class _CameraPickerViewerState extends State<CameraPickerViewer> {
 
   bool get shouldDeletePreviewFile => widget.shouldDeletePreviewFile;
 
+  bool get shouldAutoPreviewVideo => widget.shouldAutoPreviewVideo;
+
   @override
   void initState() {
     super.initState();
@@ -158,6 +165,9 @@ class _CameraPickerViewerState extends State<CameraPickerViewer> {
       await videoController.initialize();
       videoController.addListener(videoPlayerListener);
       hasLoaded = true;
+      if (shouldAutoPreviewVideo) {
+        videoController.play();
+      }
     } catch (e) {
       hasErrorWhenInitializing = true;
       realDebugPrint('Error when initializing video controller: $e');