Flutter 自定义相机功能插件 custom_cam 的使用

概述

custom_cam 是一个用于 iOS 和 Android 平台的 Flutter 插件，允许开发者轻松地设置自定义界面的相机，并支持拍照和录像功能。文件将存储在应用内部，并返回路径和媒体类型。

• 注意：尽管相机插件可以编译任何版本的 iOS，但其功能要求 iOS 10 或更高版本。如果编译为 iOS 9，则必须在使用任何相机插件功能之前通过编程检查设备上运行的 iOS 版本。

特性

• 相机权限异常处理。
• 显示实时相机预览。
• 设备方向响应式 UI。
• 录制视频。
• 拍照。
• 手势缩放。
• 通过应用文件持久化存储。

开始使用

在 pubspec.yaml 中添加依赖

首先，在 pubspec.yaml 文件中添加 custom_cam 作为依赖项：

dependencies:
  custom_cam: ^x.x.x

iOS 配置

在 ios/Runner/Info.plist 文件中添加以下键值对：

<key>NSCameraUsageDescription</key>
<string>your usage description here</string>
<key>NSMicrophoneUsageDescription</key>
<string>your usage description here</string>

Android 配置

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

minSdkVersion 21

使用示例

以下是一个简单的 Flutter 应用示例，演示如何打开相机并等待相机结果。MultimediaItem 是一个包类，包含两个参数：一个用于存储路径，另一个用于区分视频和照片。

final MultimediaItem? result = await Navigator.of(context).push(
    MaterialPageRoute(builder: (_) => const CustomCamera(
        primaryColor: Color(0xff000fff), 
        secondaryColor: Color(0xfffff0fff), 
        backgroundColor: Color(0xff000faa)
    ))
);

完整示例代码

import 'package:custom_cam/custom_cam.dart';
import 'package:flutter/material.dart';

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'CustomCam Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'CustomCam Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  String _counter = '';

  Future<void> _openCamera() async {
    final MultimediaItem? result = await Navigator.of(context).push(
        MaterialPageRoute(builder: (_) => const CustomCamera(
            primaryColor: Color(0xff000fff),
            secondaryColor: Color(0xfffff0fff),
            backgroundColor: Color(0xff000faa)
        ))
    );
    if (result != null) {
      setState(() {
        _counter = result.path;
      });
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            const Text(
              'A new file was saved to:',
            ),
            Text(
              _counter,
              style: Theme.of(context).textTheme.headlineMedium,
            ),
          ],
        ),
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: _openCamera,
        tooltip: 'Camera',
        child: const Icon(Icons.camera_alt),
      ),
    );
  }
}