Remote Camera Watch — Overview

Wear OS 워치를 Android 폰 카메라의 저지연 리모컨으로 사용하는 앱입니다. 폰이 보는 화면을 워치에서 실시간으로 미리 보며 원격으로 촬영 · 모드 전환 · 타이머 · 플래시 · 카메라 전환 등을 제어할 수 있습니다. 삼각대 위 셀프 샷, 단체 사진, 브이로그 모니터링, 자연스러운 캔디드 샷에 특화되어 있습니다.

주요 기능

• 실시간 라이브 프리뷰 (Low Latency) — 폰 카메라 프레임을 JPEG로 압축해 ChannelClient로 워치에 저지연 스트리밍
• 원격 셔터 — 사진 · 동영상 모드 전환, 탭 한 번으로 촬영
• 타이머 — 즉시 / 3초 / 5초 / 10초 (카운트다운마다 워치 진동)
• 타이머 사운드 — 없음·사운드 1·2·3 중 선택하여 휴대폰과 워치 사진 타이머의 각 초에 휴대폰에서 재생
• 회전 줌 제어 — 지원 워치의 크라운·회전 버튼·물리/터치 베젤로 연결된 카메라 화면에서 빠르게 줌 조절
• 카메라 전환 — 전면(셀카) ↔ 후면(고화질)
• 플래시 — 켜기 / 끄기 / 자동
• 화면 비율 — 4:3 / 16:9 / 1:1
• 미러 모드 — 셀카 좌우 반전
• 수평계 — 폰의 roll/pitch 기울기를 모바일과 워치 프리뷰에 표시하고, 기준 각도에 가까울 때만 자동 표시
• 인터벌 촬영 — 셔터 한 번으로 1장 / 3장 / 5장 연속 촬영
• 최근 촬영 갤러리 — 최근 사진의 저해상도 미리보기를 최대 5장까지 워치에서 좌우 탭·스와이프로 탐색하고 하단 닫기 버튼이나 취소키로 라이브 프리뷰에 복귀
• Cover / AoD 화면 — 폰 화면을 이미지 또는 시계형 어두운 화면으로 덮기; 검은 화면은 Cover의 블랙 샘플로 선택
• 자동 연결 — CapabilityClient로 watch_go_cam 기능을 가진 워치 탐색 후 자동 연결
• 연결·카메라 진단 — 관측된 실패 단계를 구분하고 실행 가능한 다시 확인·앱 열기·재연결·권한·카메라 복구 행동 제공
• 진동 피드백 — 셔터·타이머 카운트다운에 손목 진동

기술 스택

Mobile App (:app)

• CameraX — ImageAnalysis 유스케이스로 프레임 캡처
• YUV → JPEG 변환 — YuvImage로 NV21 포맷을 JPEG 압축 (전송 크기 최적화)
• Wearable ChannelClient — /camera_preview 채널로 저지연 전송
• 최근 촬영 갤러리 채널 — /recent_capture_gallery에서 최대 5개의 길이 프레이밍 JPEG 썸네일을 라이브 스트림과 독립적으로 전송
• Kotlin Coroutines — 비동기 스트리밍, Channel.CONFLATED로 백프레셔 관리
• 권한: CAMERA 필수. Android 12(API 31)+에서 BLUETOOTH_CONNECT, BLUETOOTH_SCAN 필수

Wear OS App (:wear)

• Jetpack Compose — 프리뷰 UI
• Bitmap Decoding — BitmapFactory로 수신 바이트 디코딩
• Keep Screen On — 프리뷰 동안 화면 유지 (WAKE_LOCK 권한)

연결 및 스트리밍 아키텍처

1. 탐색 및 연결

• Mobile MainActivity가 CapabilityClient로 watch_go_cam 기능 노드 주기 탐색 (checkConnectedDevices)
• 노드 발견 시 syncState가 STATE_CONNECTED로 전환
• Wear 앱 실행 시 ChannelClient / MessageClient 리스너 등록 후 "Waiting for connection..."

2. 초기화 & 핸드셰이크

• Mobile → /ping 메시지 → Wear가 "Ping Received"
• Mobile → ChannelClient.openChannel("/camera_preview") → Wear가 "Waiting for video..."

3. 스트리밍 루프

• Mobile: CameraX ImageAnalysis 프레임 → YuvImage.compressToJpeg → 패킷 [프레임 크기(4B)][JPEG 데이터] 전송
• Wear: InputStream에서 Int 크기 읽고, 해당 크기만큼 바이트 → BitmapFactory → Bitmap 상태 업데이트 → Compose 렌더링

4. 종료

• Mobile: CameraManager 해제 + 채널 close
• Wear: onChannelClosed → 리소스 정리, 대기 상태 복귀

최근 촬영 갤러리

• 사진 저장 성공 시 모바일 메모리 버퍼에 320px JPEG 미리보기만 최대 5장 보관
• 리뷰 설정이 Off가 아니면 최신 사진이 선택된 갤러리를 별도 채널로 전송
• Wear는 갤러리를 닫을 때 참조를 해제하며 파일이나 MediaStore에 저장하지 않음
• 갤러리 채널 실패·종료는 /camera_preview 연결 상태와 라이브 스트림을 변경하지 않음

상태 정의

기기	상태	설명
Mobile	DISCONNECTED	연결 없음
Mobile	READY	워치 노드 탐색 완료, 채널 미개설
Mobile	CONNECTING	채널 열기 중 (프리뷰 활성, 메인 프래그먼트 한정)
Mobile	CONNECTED	프리뷰 전송 중
Wear	WAITING	연결 없음
Wear	CONNECTING	채널 열기 중
Wear	CONNECTED	프리뷰 수신 중

모바일은 위 호환 transport 상태와 별도로 다음 진단 상태를 관리합니다.

• Wear: 탐색 중 / 워치 없음 / 앱 확인 필요 / 연결 준비 / 연결 중 / 연결됨 / 응답 없음 / 연결 실패 / 연결 중단
• Camera: 확인 중 / 준비됨 / 권한 필요 / 설정에서 권한 필요 / 사용할 수 없음

워치 채널이 연결된 뒤 CameraX만 실패하면 Wear 연결은 연결됨으로 유지하고 카메라 복구 행동만 표시합니다.

성능 · 제약

• 해상도: 블루투스 대역폭 한계로 프리뷰 320×240
• 전송 품질: JPEG 압축 품질 조절로 속도/화질 균형
• 배터리: 실시간 스트리밍 + 화면 유지로 양쪽 기기 배터리 소모 빠름
• 연결: 블루투스 기본, Wi-Fi도 지원하나 지연이 길어질 수 있음
• 범위: 블루투스 범위 이탈 시 스트리밍 중단