Multi Counter — Overview

Wear OS 워치와 Android 모바일에서 작동하는 다용도 카운터 앱입니다. 화면을 탭해 숫자를 세는 싱글 카운터부터 2~4인 보드게임 스코어 카운터까지 한 앱에서 해결하며, 디지털 시계/스톱워치, 세션 히스토리, 이미지 공유 기능을 함께 제공합니다. 모바일에서 이름·색상·목표·루프 등을 설정하면 워치로 실시간 동기화됩니다.

주요 기능

• 유연한 카운터 모드 — 싱글 / 듀얼 / 트리플 / 쿼드(4분할) 즉시 전환
• 타일 빠른 실행 — 앱을 열지 않고 타일에서 바로 카운트
• 카운터 상세 설정 — 각 카운터별 이름(최대 10자)·색상·목표치·루프 모드·직접 값 수정(0~999)
• 히스토리 로그 & 이미지 공유 — 세션 기록을 모바일에서 관리하고 이미지로 공유
• 홈 화면 위젯 & 볼륨 키 카운터 — 화면을 보지 않고도 볼륨 키로 카운트
• 진동·사운드 피드백 — 탭할 때마다 햅틱으로 확신 있는 카운팅
• 시계·스톱워치 내장 — 운동 세트 사이 시간 측정 등에 활용
• 모바일-워치 실시간 동기화 — 5초 주기 pull 방식 세션 동기화

기술 스택

• 모바일 앱: Kotlin, Android View 시스템, MVVM (MainViewModel), Jetpack DataStore
• 워치 앱: Kotlin, Jetpack Compose for Wear OS, Wear Tiles
• 기기 간 통신: Wearable Data Layer API (MessageClient)
• 데이터 저장: DataStore 기반 CounterRecordDataStore (모바일) / HistoryManager (워치, 최대 50개 유지)

동기화 아키텍처

모바일이 5초 간격으로 워치에 /sync-records-request를 보내 pull:

Mobile                                        Wear
  │ ── /sync-records-request ───────────────▶ │ (5초마다)
  │ ◀── /sync-records-response ───────────── │ (wear 기록 JSON)
  │ handleCounterRecordsResponse()            │
  │ counterRecordDataStore.addCounterRecords()│
  │ ── /sync-records-response ───────────────▶│ (동기화 완료된 sessionId 회신)
  │                                           │ historyManager.removeRecordsFromHistory()

메시지 경로

중복 제거

• Mobile: sessionId 기준, 5초 미만 + 모든 카운터 0인 기록 제거, isActive=true 중 최신만 유지, 기존 title 보존
• Wear: 모바일이 회신한 sessionId 중 isActive=false만 삭제 (활성 세션은 유지)

CounterRecord 데이터 구조

data class CounterRecord(
  val sessionId: String,          // timestamp 기반 고유 ID
  val startTime: String,          // ISO 시작 시간
  val endTime: String?,           // ISO 종료 시간
  val counter1Count..counter4Count: Int,
  val counter1Color..counter4Color: Int,
  val counter1Name..counter4Name: String, // 최대 10자
  val mode: Int,                   // 싱글/듀얼/트리플/쿼드
  val isActive: Boolean,
  val activeDuration: Long,        // ms
  val title: String? = null        // Mobile 전용
)

아키텍처 요약

• 모바일 (:app) — MainActivity가 주기적 동기화 트리거, MainViewModel이 MessageClient.OnMessageReceivedListener 구현
• 워치 (:wear) — DataLayerListenerService가 메시지 수신·처리, HistoryManager가 DataStore에 기록 관리
• 공용 라이브러리: :watch-go-info-fragment, :onboarding