SuperAPI AI 工具集

camera-capture

编程与开发

查看项目

更新于 11-08 17:06

技能介绍

Camera Capture(iOS)是 Meta Wearables DAT iOS 提供的实验性独立高质量拍照路径,由 camera.photo 接口暴露。它与 stream.capturePhoto 不同:后者在视频流保持活动时拍照,而 Camera Capture 面向独立拍照场景。

用途与前置条件 应用需在 Wearables Developer Center 获得 Camera 批准,并具备 .camera 权限。Camera 应在 DeviceSession 启动之后再添加。由于 Stream 与独立 Photo 会竞争相机硬件,开始 Photo 前必须先停止活动的 Stream。

使用方式 在调用 start() 之前注册所需 publisher,然后等待 .started 状态再请求拍照。示例流程为:通过 session.addCamera(config: StreamConfiguration()) 获取 camera,取 camera.photo,使用 ListenerTokenBag 保存监听令牌,通过 photo.photoDataPublisher.listen 接收拍照结果,并在主线程更新预览;随后调用 photo.start()。当 Photo 达到 .started 后,调用 photo.capturePhoto(resolution: .full, quality: .high) 指定所需分辨率与质量。拍照是异步的,图像数据经 photoDataPublisher 返回,传输进度通过 transferProgressPublisher 观察,失败通过 errorPublisher 获取。分辨率更高、质量更高的拍照处理与传输耗时更长。

错误与清理 在 .started 之前调用 capture 会发布 PhotoError.notReady。初始化与拍照失败均通过 errorPublisher 返回。需保持 Photo 与 photoTokens 存活直到交付完成,然后停止 Photo、清空 token bag 并停止 Camera。photo.stop() 返回 .stopped 后,同一个 camera.photo 实例可通过 photo.start() 重新启动。停止 Camera 或父 session 也会停止其子项。

测试 使用 MockDeviceKit 时,可在请求拍照前通过 glasses.services.cameraCapture.setCapturedPhoto(fileURL:) 配置下一张图像,或用 simulateCaptureFailure() 模拟一次性失败。

可用性 独立 Camera Capture 目前为实验性功能,应用可用于开发与 Beta 测试,但暂不能发布到生产发布渠道。