从 v1.x 升级

v1.x → v2.x 的破坏性变更清单与迁移方法。当前最新版的完整 API 见 API 参考。

---

1. photoResolution / videoResolution → 改用 quality

CameraMode 的 photoResolution 和 videoResolution 字段已移除,统一改用 quality(0~1 的 JPEG 压缩系数,默认 0.9)控制输出质量:

// ❌ v1.x(已移除)
{ mode: 'single', photoResolution: '4k' }

// ✅ v2.x
{ mode: 'single', quality: 0.9 }

---

2. watermark 配置项:移除后又回归

api.open() 的 watermark 参数在 v2.0.0 中一度被移除,已在 v2.1.x 重新加入并增强:现支持多行文字(content: string[])、六方位对齐(position)与 Skia 离屏合成。

迁移方式:升级到 v2.1.x 或更高版本,参照指南 → 水印的新 API 传参。注意水印仅对照片生效,录像无水印。

---

3. 类型改从顶层入口导入

v1.x 部分类型需通过 deep path 导入;v2.x 起所有公开类型都从 @unif/react-native-camera 顶层统一导出:

// ❌ v1.x(已废弃的 deep path)
import type { CameraResult } from '@unif/react-native-camera/lib/typescript/src/utils';

// ✅ v2.x:直接从顶层入口导入
import type { CameraResult, OpenConfig, CameraMode } from '@unif/react-native-camera';

无需任何 deep path。完整类型列表见 API 参考 → 类型。

---

下一步

• 安装 —— 确认新版 peerDeps 装齐(v2.x 仅支持新架构)
• 核心概念 —— 模态相机心智模型
• API 参考 → 类型 —— 当前版本的完整类型定义