Flutter相机功能插件camerawesome的使用

简介

CamerAwesome 是一个Flutter插件，旨在简化在应用程序中嵌入相机体验的过程。它提供了一个完全可定制的相机界面，您可以使用内置的优秀界面或根据需要进行自定义。

安装与使用

添加依赖

在pubspec.yaml文件中添加以下内容：

dependencies:
  camerawesome: ^2.0.0-dev.1

平台特定设置

iOS

在ios/Runner/Info.plist文件中添加以下权限：

<key>NSCameraUsageDescription</key>
<string>Your own description</string>

<key>NSMicrophoneUsageDescription</key>
<string>To enable microphone access when recording video</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>To enable GPS location access for Exif data</string>

Android

在android/app/build.gradle文件中修改最小SDK版本为21（或更高）：

minSdkVersion 21

如果您希望录制带有音频的视频，请在AndroidManifest.xml文件中添加以下权限：

<uses-permission android:name="android.permission.RECORD_AUDIO" />

如果您希望保存图片的位置信息，请添加以下权限：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

导入包

在您的Flutter应用中导入CamerAwesome包：

import 'package:camerawesome/camerawesome_plugin.dart';

使用内置界面

只需使用我们的构造器即可创建完整的相机体验：

CameraAwesomeBuilder.awesome(
  saveConfig: SaveConfig.photoAndVideo(),
  onMediaTap: (mediaCapture) {
    OpenFile.open(mediaCapture.filePath);
  },
),

创建自定义界面

如果内置界面不够用，可以使用custom()构造器来自定义界面：

CameraAwesomeBuilder.custom(
  saveConfig: SaveConfig.photo(),
  builder: (state, previewSize, previewRect) {
    // 在这里创建您的界面
  },
)

监听媒体捕获事件

使用onMediaCaptureEvent监听图片或视频捕获事件：

onMediaCaptureEvent: (event) {
  switch ((event.status, event.isPicture, event.isVideo)) {
    case (MediaCaptureStatus.capturing, true, false):
      debugPrint('Capturing picture...');
    case (MediaCaptureStatus.success, true, false):
      event.captureRequest.when(
        single: (single) {
          debugPrint('Picture saved: ${single.file?.path}');
        },
        multiple: (multiple) {
          multiple.fileBySensor.forEach((key, value) {
            debugPrint('multiple image taken: $key ${value?.path}');
          });
        },
      );
    case (MediaCaptureStatus.failure, true, false):
      debugPrint('Failed to capture picture: ${event.exception}');
    case (MediaCaptureStatus.capturing, false, true):
      debugPrint('Capturing video...');
    case (MediaCaptureStatus.success, false, true):
      event.captureRequest.when(
        single: (single) {
          debugPrint('Video saved: ${single.file?.path}');
        },
        multiple: (multiple) {
          multiple.fileBySensor.forEach((key, value) {
            debugPrint('multiple video taken: $key ${value?.path}');
          });
        },
      );
    case (MediaCaptureStatus.failure, false, true):
      debugPrint('Failed to capture video: ${event.exception}');
    default:
      debugPrint('Unknown event: $event');
  }
},

示例代码

以下是一个完整的示例代码，展示了如何在Flutter应用中使用CamerAwesome插件：

import 'dart:io';

import 'package:camerawesome/camerawesome_plugin.dart';
import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart';

void main() {
  runApp(const CameraAwesomeApp());
}

class CameraAwesomeApp extends StatelessWidget {
  const CameraAwesomeApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(
      title: 'camerAwesome',
      home: CameraPage(),
    );
  }
}

class CameraPage extends StatelessWidget {
  const CameraPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Container(
        color: Colors.white,
        child: CameraAwesomeBuilder.awesome(
          onMediaCaptureEvent: (event) {
            switch ((event.status, event.isPicture, event.isVideo)) {
              case (MediaCaptureStatus.capturing, true, false):
                debugPrint('Capturing picture...');
              case (MediaCaptureStatus.success, true, false):
                event.captureRequest.when(
                  single: (single) {
                    debugPrint('Picture saved: ${single.file?.path}');
                  },
                  multiple: (multiple) {
                    multiple.fileBySensor.forEach((key, value) {
                      debugPrint('multiple image taken: $key ${value?.path}');
                    });
                  },
                );
              case (MediaCaptureStatus.failure, true, false):
                debugPrint('Failed to capture picture: ${event.exception}');
              case (MediaCaptureStatus.capturing, false, true):
                debugPrint('Capturing video...');
              case (MediaCaptureStatus.success, false, true):
                event.captureRequest.when(
                  single: (single) {
                    debugPrint('Video saved: ${single.file?.path}');
                  },
                  multiple: (multiple) {
                    multiple.fileBySensor.forEach((key, value) {
                      debugPrint('multiple video taken: $key ${value?.path}');
                    });
                  },
                );
              case (MediaCaptureStatus.failure, false, true):
                debugPrint('Failed to capture video: ${event.exception}');
              default:
                debugPrint('Unknown event: $event');
            }
          },
          saveConfig: SaveConfig.photoAndVideo(
            initialCaptureMode: CaptureMode.photo,
            photoPathBuilder: (sensors) async {
              final Directory extDir = await getTemporaryDirectory();
              final testDir = await Directory(
                '${extDir.path}/camerawesome',
              ).create(recursive: true);
              if (sensors.length == 1) {
                final String filePath =
                    '${testDir.path}/${DateTime.now().millisecondsSinceEpoch}.jpg';
                return SingleCaptureRequest(filePath, sensors.first);
              }
              // Separate pictures taken with front and back camera
              return MultipleCaptureRequest(
                {
                  for (final sensor in sensors)
                    sensor:
                        '${testDir.path}/${sensor.position == SensorPosition.front ? 'front_' : "back_"}${DateTime.now().millisecondsSinceEpoch}.jpg',
                },
              );
            },
            videoOptions: VideoOptions(
              enableAudio: true,
              ios: CupertinoVideoOptions(
                fps: 10,
              ),
              android: AndroidVideoOptions(
                bitrate: 6000000,
                fallbackStrategy: QualityFallbackStrategy.lower,
              ),
            ),
            exifPreferences: ExifPreferences(saveGPSLocation: true),
          ),
          sensorConfig: SensorConfig.single(
            sensor: Sensor.position(SensorPosition.back),
            flashMode: FlashMode.auto,
            aspectRatio: CameraAspectRatios.ratio_4_3,
            zoom: 0.0,
          ),
          enablePhysicalButton: true,
          previewAlignment: Alignment.center,
          previewFit: CameraPreviewFit.contain,
          onMediaTap: (mediaCapture) {
            mediaCapture.captureRequest.when(
              single: (single) {
                debugPrint('single: ${single.file?.path}');
                single.file?.open();
              },
              multiple: (multiple) {
                multiple.fileBySensor.forEach((key, value) {
                  debugPrint('multiple file taken: $key ${value?.path}');
                  value?.open();
                });
              },
            );
          },
          availableFilters: awesomePresetFiltersList,
        ),
      ),
    );
  }
}

通过以上步骤，您可以在Flutter应用中轻松集成并使用CamerAwesome插件来实现强大的相机功能。更多详细信息请参考官方文档。