Keepsake——拾刻相机的鸿蒙原生影像实践

1. CameraPage：统一承载拍摄工作台#

CameraPage.ets 是应用最复杂的页面，它同时管理取景、拍摄、底部控制栏、票根预览、色卡面板和图库入口。页面没有把每个功能拆成互不相关的页面，而是用面板模式区分 CONTROLS、COLOR_PRESETS、COLOR_EDITOR 和 TEMPLATES，让用户在同一取景上下文中完成调整。

CameraModel.ets 则把相机生命周期从页面中抽出来，负责创建相机输入、预览输出和拍照输出，并向页面提供当前镜头、变焦范围和运行状态。这样做的好处是：页面只关心“当前能不能拍”和“用户选择了什么”，相机资源的创建、释放和异常处理集中在模型层。

项目在模块配置中声明了相机、麦克风、定位和网络权限。定位能力用于补充票根中的地点信息，麦克风权限用于动态照片相关的声音场景；具体权限仍然由系统在运行时授予，应用不能绕过用户授权。

2. 色卡系统：把参数化调色变成可保存配置#

色卡不是几张静态滤镜图片。ColorCardProfile 中保存了色温、色调、饱和度、强度、对比度、褪色、颗粒和暗角等参数，同时还包含色卡分类、配方编号和预览资源。

ColorCardStore 负责内置色卡和用户自定义色卡的读取、校验、归一化与持久化。应用启动时会过滤已经退役的旧预设，避免历史 preferences 中的旧数据被误认为是用户自定义内容重新出现。这是一个很小但很重要的数据迁移细节：资源版本变化时，持久化数据也必须跟着升级。

取景阶段使用 ColorTextureOverlay 等组件呈现实时效果，导出阶段则把相同的调色参数传给图片或动态视频处理流程。预览参数与最终结果共用一份配置，能够减少“预览看起来是一个效果，保存后变成另一个效果”的偏差。

3. 票根模板：结构化生成，而不是把文字画死#

TicketTemplate.ets 用数据结构描述票根：图片区域、画布比例、标题、页脚、条码、打孔线、颜色和圆角都由模板字段定义。模板包括横版票根、竖版旅行邮票、拍立得、地图和液态玻璃等风格。

模板渲染时，应用会把城市、日期、时间、序列号、设备型号和自定义文字组装成 TicketVariables，再交给 TicketOverlay 或 PhotoPrintOverlay 绘制。这样一来，模板本身是可复用的，动态信息也不会被写死在图片资源里。

票根编辑页和取景页共用模板注册表，因此用户可以在设置页指定默认票根，也可以在拍摄现场临时切换。对于不同画幅，项目还维护了照片槽的裁切比例和输出比例，避免照片被简单拉伸。

4. 动态照片：静态封面与视频轨道一起处理#

动态照片是 Keepsake 中最有工程挑战的一部分。静态封面可以直接生成票根图层，但视频部分需要逐帧叠加相同的图片槽、色彩参数和透明票根层。

MovingPhotoVideoComposer.ets 的处理流程大致如下：

1. 读取动态照片封面、票根透明图层和视频输入文件。
2. 把封面和叠加层解码为统一尺寸的 RGBA 像素数据。
3. 将照片区域、票根区域、圆角、色温、饱和度、颗粒等参数传入 native transcoding bridge。
4. 输出新的 MP4，并检查文件是否真实生成且大小大于零。
5. 关闭文件、释放 ImageSource 和 PixelMap，避免长时间使用相机后出现资源泄漏。

代码中还对动态照片的图片路径、视频路径和 URI 做了区分。应用沙箱文件路径用于写入内容，fileUri 用于资源引用，二者不能混用。这个边界处理直接影响动态照片能否被正确导出。

5. 应用内图库：元数据与文件本体分离#

GalleryStore.ets 的设计是“轻量元数据 + 应用沙箱文件”。图库记录会保存照片路径、是否为动态照片、票根模板、地点、时间、设备型号、调色参数、分享背景和导出状态；照片本体则复制到 filesDir/gallery，避免把重要文件放在可能被系统清理的 cache 目录里。

图库页面支持预览、编辑、重新调色、删除和保存到系统相册。对于动态照片，页面需要同时管理静态封面和视频资源，播放时再根据记录中的参数还原对应的预览效果。