欢迎加入开源鸿蒙跨平台社区： https://openharmonycrossplatform.csdn.net

Flutter 三方库 camera 鸿蒙化相机功能实战

摘要

camera 是 Flutter 生态中用于实现相机功能的官方插件，支持相机预览、拍照、录像等功能。本文基于 OpenHarmony TPC 仓库的适配版本，详细讲解 camera 在鸿蒙项目中的接入流程、权限配置和核心 API 使用。

核心要点：

• 配置相机和存储权限
• 实现相机预览和拍照功能
• 处理相机常见问题

一、相机功能架构

二、接入步骤

2.1 配置 pubspec.yaml

dependencies:
  flutter:
    sdk: flutter
  
  camera:
    git:
      url: https://atomgit.com/openharmony-tpc/flutter_packages.git
      path: packages/camera/camera

2.2 配置权限（module.json5）

{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:camera_reason",
        "usedScene": { "abilities": ["EntryAbility"], "when": "inuse" }
      },
      {
        "name": "ohos.permission.WRITE_MEDIA",
        "reason": "$string:write_media_reason",
        "usedScene": { "abilities": ["EntryAbility"], "when": "inuse" }
      }
    ]
  }
}

2.3 核心代码示例

import 'package:camera/camera.dart';

class CameraService {
  CameraController? _controller;

  Future<void> initializeCamera() async {
    final cameras = await availableCameras();
    _controller = CameraController(
      cameras[0],
      ResolutionPreset.medium,
    );
    await _controller?.initialize();
  }

  CameraController? get controller => _controller;

  Future<XFile?> takePicture() async {
    if (_controller != null && _controller!.value.isInitialized) {
      return await _controller!.takePicture();
    }
    return null;
  }

  void dispose() {
    _controller?.dispose();
  }
}

三、运行成功截图

附录：Schema.org 结构化数据

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Flutter 三方库 camera 鸿蒙化相机功能实战",
  "description": "基于 OpenHarmony TPC 仓库，详细讲解 camera 在鸿蒙项目中的接入流程、权限配置与相机功能实现。",
  "author": { "@type": "Person", "name": "OpenHarmony 跨平台开发者" },
  "publisher": { "@type": "Organization", "name": "OpenHarmony 跨平台社区", "url": "https://openharmonycrossplatform.csdn.net" },
  "datePublished": "2026-05-07",
  "dateModified": "2026-05-07",
  "mainEntityOfPage": "https://openharmonycrossplatform.csdn.net",
  "keywords": ["开源鸿蒙", "OpenHarmony", "Flutter for OpenHarmony", "camera", "相机功能", "三方库适配"],
  "inLanguage": "zh-CN"
}
</script>