HarmonyOS相机开发：CameraPicker与Camera Kit选型指南

1. HarmonyOS相机开发方案选型指南

在HarmonyOS生态中开发相机应用时，开发者面临的首要问题就是方案选择。系统提供了两种截然不同的实现路径，各有其适用场景和技术特点。

1.1 CameraPicker：快速集成方案

CameraPicker是系统提供的开箱即用解决方案，其核心优势在于"三无"特性：

• 无权限要求：直接调用系统相机服务，无需声明ohos.permission.CAMERA权限
• 无界面开发：完全复用系统相机UI，省去视图层开发工作量
• 无设备管理：由系统处理相机硬件调度，开发者无需关心设备状态

典型应用场景包括：

• 用户头像采集
• 证件照拍摄
• 简单的媒体内容获取

技术实现上，CameraPicker本质上是通过Intent机制与系统相机进行跨进程通信。当调用picker.pick()方法时，系统会启动相机Activity，用户操作完成后通过回调返回结果。这种设计虽然限制了定制能力，但确保了稳定的拍摄体验。

1.2 Camera Kit：深度定制方案

Camera Kit提供了完整的相机控制能力链，包含以下核心模块：

• CameraManager：设备管理入口，支持枚举摄像头设备
• CameraInput：物理摄像头抽象，控制设备开关
• PreviewOutput：预览流输出通道
• PhotoOutput：静态图像捕获通道
• VideoOutput：视频录制通道

与CameraPicker相比，Camera Kit需要处理更多技术细节：

1. 必须申请相机权限
2. 需自行管理Surface生命周期
3. 要处理设备兼容性问题
4. 需优化性能以避免预览卡顿

适合需要特殊功能的场景：

• 美颜相机
• 专业模式
• AR特效应用
• 扫码识别等计算机视觉应用

1.3 方案对比决策矩阵

对于大多数基础应用，建议优先考虑CameraPicker。只有当业务确实需要特殊拍摄模式或图像处理时，才值得投入Camera Kit的开发成本。

2. CameraPicker实战开发详解

2.1 核心架构解析

CameraPicker的工作流程可分为三个阶段：

1. 初始化阶段：配置输出目标和拍摄参数
2. 交互阶段：用户与系统相机界面交互
3. 结果处理阶段：返回媒体文件并释放资源

关键要注意的是文件URI的处理机制。当指定saveUri时，系统会将拍摄结果写入指定路径；未指定时则存入媒体库，返回content://格式的URI。

2.2 完整实现示例

以下是带错误处理的增强版实现：

typescript复制import { camera, cameraPicker as picker } from '@kit.CameraKit';
import { fileIo, fileUri } from '@kit.CoreFileKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct CameraPickerExample {
  @State mediaUri: string = '';
  @State mediaType: string = '';
  @State errorMessage: string = '';

  // 创建带时间戳的唯一文件名
  private generateFileName(): string {
    const now = new Date();
    return `capture_${now.getFullYear()}${(now.getMonth()+1).toString().padStart(2,'0')}${now.getDate().toString().padStart(2,'0')}_${now.getTime()}`;
  }

  // 安全创建输出文件
  private async createOutputFile(context: Context): Promise<string> {
    try {
      const tempDir = context.filesDir;
      const fileName = this.generateFileName() + '.tmp';
      const filePath = `${tempDir}/${fileName}`;
      
      // 原子性文件操作
      const fd = fileIo.openSync(filePath, fileIo.OpenMode.CREATE | fileIo.OpenMode.READ_WRITE);
      fileIo.closeSync(fd);
      
      return filePath;
    } catch (error) {
      this.handleError(error);
      return '';
    }
  }

  // 错误统一处理
  private handleError(error: BusinessError): void {
    console.error(`ErrorCode: ${error.code}, Message: ${error.message}`);
    this.errorMessage = `操作失败，错误码：${error.code}`;
  }

  // 带重试机制的拍摄调用
  private async captureWithRetry(context: Context, retries = 3): Promise<void> {
    try {
      const filePath = await this.createOutputFile(context);
      if (!filePath) return;

      const uri = fileUri.getUriFromPath(filePath);
      const profile: picker.PickerProfile = {
        cameraPosition: camera.CameraPosition.CAMERA_POSITION_BACK,
        saveUri: uri
      };

      const result = await picker.pick(
        context,
        [picker.PickerMediaType.PHOTO, picker.PickerMediaType.VIDEO],
        profile
      );

      i