Camera Capture(Android)是 Meta Wearables DAT Android SDK 提供的实验性独立高质量拍照路径,通过 camera.photo 暴露。它与 stream.capturePhoto() 不同:后者在视频流保持活动期间拍照,而独立 Photo 与 Stream 共享摄像头硬件,因此访问 Photo 前需先停止正在运行的 Stream。
用途与前提:该能力用于从已连接的眼镜拍摄独立的高质量照片。应用需在 Wearables Developer Center 获得 Camera 批准,并声明 Permission.CAMERA;Camera 应在 DeviceSessionState.STARTED 之后添加。
主要能力与使用方式:访问 camera.photo 会惰性创建并启动独立的 Photo 子节点。应收集其数据流,并等待 PhotoState.STARTED 后再启用拍照按钮。示例中通过 photo.state 更新按钮状态,通过 photo.photoStream 接收拍照结果并保存 imageData 与 metadata,通过 photo.transferProgressStream 更新进度,通过 photo.errors 展示错误。当状态达到 PhotoState.STARTED 后,调用 photo.capturePhoto(resolution = PhotoResolution.FULL, quality = PhotoQuality.HIGH) 并指定所需分辨率与质量。拍照是异步的,数据经 photoStream 返回。
错误与清理:需处理 errors 中的未就绪、拍照、初始化、断开连接、忙、服务、权限及设备健康等错误。数据交付后,应停止 Photo、取消其收集器并停止 Camera。Photo 在 stop() 后进入终结状态,再次访问 camera.photo 会返回同一个已停止实例;若要再次拍照,需从会话中移除当前 Camera,添加新 Camera,再从新实例访问 Photo。停止 Camera 或父会话也会级联清理。
测试:可使用 MockDeviceKit,通过 glasses.services.cameraCapture.setCapturedPhoto(imageUri) 配置下一张图像,或用 simulateCaptureFailure() 模拟一次性失败。
可用性限制:独立 Camera Capture 仍为实验性功能,应用可用于开发和 Beta 测试,但暂不能发布到生产发布渠道。