SuperAPI AI Directory

camera-capture

Coding & development

View repository

Updated 11-08 17:06

About this skill

Camera Capture (Android)

Camera Capture is the experimental standalone high-quality photo path exposed by camera.photo. It is different from stream.capturePhoto(), which takes a photo while video streaming remains active.

Prepare Camera and permission

The app needs Camera approval in Wearables Developer Center and Permission.CAMERA. Add Camera only after DeviceSessionState.STARTED. Stream and standalone Photo compete for camera hardware, so stop an active Stream before accessing Photo.

Observe Photo

Accessing camera.photo lazily creates and starts the standalone Photo child. Collect its flows and wait for PhotoState.STARTED before enabling capture.

val photo = camera.photo

photoStateJob = lifecycleScope.launch { photo.state.collect { state -> photoButtonEnabled = state == PhotoState.STARTED } } photoDataJob = lifecycleScope.launch { photo.photoStream.collect { capture -> save(capture.imageData, capture.metadata) } } progressJob = lifecycleScope.launch { photo.transferProgressStream.collect { progress -> updateProgress(progress) } } errorJob = lifecycleScope.launch { photo.errors.collect { error -> showError(error.description) } }


After Photo reaches `PhotoState.STARTED`, call `photo.capturePhoto(resolution = PhotoResolution.FULL, quality = PhotoQuality.HIGH)` with the desired resolution and quality. Capture is asynchronous; data arrives through `photoStream`. Collect `transferProgressStream` for progress and `errors` for failures.

## Errors and cleanup

Handle not-ready, capture, setup, disconnect, busy, service, permission, and device-health errors from `errors`. After delivery, stop Photo, cancel its collectors, and stop Camera.

Photo is terminal after `stop()`, and accessing `camera.photo` again returns the same stopped instance. To capture again, remove the current Camera from the session, add a new Camera, and access Photo from that new instance. Stopping Camera or the parent session also cascades cleanup.

## Test with MockDeviceKit

Configure the next image with `glasses.services.cameraCapture.setCapturedPhoto(imageUri)` or use `simulateCaptureFailure()` for a one-shot failure.

## Availability

Standalone Camera Capture is experimental. Apps can use it for development and beta testing, but cannot publish it to production release channels yet.