更好相机插件技术文档

更好相机插件技术文档

本插件是官方Camera插件的一个分支，旨在提供缺失功能的支持直至官方完全覆盖。目前，虽然稳定性有待提升，但我们正积极进行开发与优化。此文档将指导您安装、使用并深入理解flutter_better_camera插件。

安装指南

要集成flutter_better_camera到您的Flutter项目，请遵循以下步骤：

1. 打开您的项目中的pubspec.yaml文件。
2. 在dependencies部分添加以下行：

   flutter_better_camera: ^版本号
   

   （请替换版本号为您实际需要的最新稳定版本）
3. 保存文件后，在终端运行flutter pub get以下载并安装依赖项。

对于iOS平台，还需做如下配置：

• 打开ios/Runner/Info.plist。
• 添加以下两段XML代码来请求摄像头和麦克风权限：

  <key>NSCameraUsageDescription</key>
  <string>应用需要访问摄像头。</string>
  <key>NSMicrophoneUsageDescription</key>
  <string>应用需要访问麦克风。</string>
  

对于Android平台：

• 确保在android/app/build.gradle中minSdkVersion至少为21。
• 在同一文件中，确认已声明了正确的最低API级别。
• 修改android/app/src/main/AndroidManifest.xml，加入必要的权限：

  <uses-permission android:name="android.permission.CAMERA"/>
  <uses-permission android:name="android.permission.FLASHLIGHT"/>
  <uses-feature android:name="android.hardware.camera"/>
  <uses-feature android:name="android.hardware.camera.front" android:required="false"/>
  <uses-feature android:name="android.hardware.camera2" android:required="false"/>
  <uses-feature android:name="android.hardware.camera.autofocus" android:required="false"/>
  <uses-feature android:name="android.hardware.camera.flash" android:required="false"/>
  

使用说明

显示相机预览

在Flutter中创建一个Widget，并使用cameraController初始化预览。

拍摄照片

调用cameraController.takePicture()方法保存图片至指定路径。

录制视频

通过cameraController.startVideoRecording()开始录制，完成后使用cameraController.stopVideoRecording()结束，并获取视频文件路径。

Dart中访问图像流

利用提供的API，实现在Dart端实时处理来自相机的图像数据。

控制选项

• 闪光灯控制：使用cameraController.setFlashMode(FlashMode.on)等模式来切换。
• 缩放控制：调用cameraController.setZoomLevel(zoomValue)改变相机缩放。
• 自动曝光/Auto Exposure 及 自动对焦的开关操作，具体API请参考插件详细文档。

API使用文档

请注意，详细的API文档应包含每个方法的签名、参数说明、返回值以及示例代码。因篇幅限制，这里不列出所有API详情。在正式文档或插件源码注释中，您能找到如cameraController.initialize()用于初始化控制器，cameraController.dispose()释放资源等方法的详细信息。

示例项目

此插件仓库包含一个示例工程，展示了如何整合上述功能。您可以将其作为起点，快速理解和应用到自己的项目中。

后续特性计划

• 点击聚焦
• 连拍模式
• 自定义相机预览比例
• 优化图片质量
• 白平衡控制

我们鼓励社区成员提出问题、报告bug并积极参与贡献，共同推动这个项目的发展。