camerakit

HarmonyOS趣味相机实战第24篇：前摄镜像、旋转补偿与识别框坐标统一前置摄像头最容易出现一种“每个模块单独看都对，叠在一起却错”的问题：预览像镜子，保存后的 JPEG 又可能按拍摄参数镜像，人物识别框还来自传感器或算法坐标。如果三个环节各自补一次方向，最终会出现左右颠倒、识别框跑到另一侧、水印文字反写等现象。

HarmonyOS趣味相机实战第19篇：CameraKit输出Profile协商、宽高比评分与会话提交CameraKit 返回了多个 previewProfiles 和 photoProfiles 时，直接取第一个元素虽然代码最短，却把画面比例、性能和设备排序规则交给了底层实现。不同设备上的第一个 Profile 可能宽高比不同、分辨率过高，甚至与页面 316 x 390 的竖屏 Cover 预览不匹配，最终造成裁剪过多、识别坐标难对齐或会话配置失败。

HarmonyOS趣味相机实战第16篇：实时识别采样、Busy锁与Generation并发治理在相机预览上做人体识别，最直接的实现是不断从 Surface 创建 PixelMap，再调用 CoreVisionKit。这个方案能跑起来，却容易在真机上出现预览掉帧、多个识别任务重叠、切换镜头后旧结果回写、页面退出仍持有 PixelMap 等问题。

HarmonyOS趣味相机实战第13篇：CameraPicker与CameraKit选型、系统拍照回退及架构边界HarmonyOS 应用需要“拍一张照片”时，并不一定要自己管理 CameraInput、PhotoSession、XComponent Surface 和 PhotoOutput。若产品只需要调用系统拍摄界面并拿回结果，CameraPicker 能显著减少相机生命周期代码；若产品需要在应用内实时预览、倒计时、闪光灯、水印叠层、人体识别、前后镜头切换或双摄扩展，则必须使用 CameraKit 自定义会话。

HarmonyOS趣味相机实战第11篇：从单摄切换升级前后双摄同开、能力探测与降级设计当前 D:/APP/1quweixiangji 趣味相机已经完成前后镜头发现、单镜头预览、镜头切换和 PhotoOutput 拍照，但它一次只维护一个 CameraInput、一个 PhotoSession 和一个 XComponent Surface。若要升级为“前后双摄同开”，不能简单地连续调用两次 createCameraInput()：设备可能没有前后两个逻辑摄像头，也可能不支持并发；支持并发的机型还需要使用并发能力结果提供的输出配置，并以受限能力模式打开输入。

HarmonyOS趣味相机实战第12篇：CameraKit错误分层、相机占用恢复与用户可重试状态机CameraKit 相机项目最难排查的故障往往都被用户描述成一句“相机打不开”。实际原因可能完全不同：相机权限被拒绝、设备没有可用镜头、XComponent Surface 尚未创建、旧 PhotoSession 没释放、相机被其他应用占用、photoAvailable 没在超时窗口内返回，甚至只是页面拿到了旧任务的迟到 PixelMap。如果所有错误都显示“请重试”，用户无法恢复，开发者也无法从日志定位。

HarmonyOS趣味相机实战第5篇：CameraKit资源释放、PixelMap生命周期与预览黑屏排查相机应用最容易出现的不是“代码编译不过”，而是运行一段时间后预览黑屏、切后台回来相机被占用、连续拍照后卡顿、保存后内存涨、前后摄像头切换失败。这些问题通常不是一个 UI 按钮能解决的，而是 CameraKit 会话、PreviewOutput、PhotoOutput、MetadataOutput、CameraInput、PixelMap、ImageSource、CoreVision 检测器和页面状态没有形成清晰的生命周期。

HarmonyOS趣味相机实战第1篇：工程结构、相机权限申请与真实拍摄主流程相机类 App 的难点不在“页面放一个拍照按钮”，而在权限、设备、预览、拍照、资源释放和本地保存这些环节必须连成闭环。D:/APP/1quweixiangji 是一个 HarmonyOS ArkTS 本地水印相机项目，当前已经覆盖相机权限申请、摄像头检测、前后摄像头切换、CameraKit 预览、定时拍照、拍照预览弹窗、本地相册保存和水印信息持久化。

我是有底线的