2048 Watch Game — Overview

Wear OS 워치에서 즐기는 2048 퍼즐 게임입니다. 클래식 숫자 합치기 퍼즐을 원형/사각형 작은 화면에 맞게 최적화했으며, 주간/월간 글로벌 랭킹 서버와 연결되어 전 세계 플레이어와 경쟁할 수 있습니다. 모바일 앱은 랭킹 확인, 이름 등록, 설정 관리 용도로 사용됩니다.

주요 기능

• 2048 퍼즐 — 스와이프로 타일을 합쳐 2048 타일을 만들거나 최고 점수 도전
• 햅틱 피드백 — 타일 합칠 때 진동
• 자동 저장 — 앱을 나갔다가 돌아와도 이어하기
• 플레이 타임 표시 — 설정에 따라 워치 화면에 HH:MM 형식으로 표시 (1분 주기 갱신, 실제 플레이 시간만 측정)
• 글로벌 랭킹 — 주간·월간 랭킹 서버 등록·조회
• 유니크 이름 시스템 — 한 번 등록된 이름은 글로벌 유니크, 본인만 변경 가능
• 애니메이션 On/Off — 워치 게임 전환 애니메이션 조정

기술 스택

• 모바일 앱: Kotlin, Android View 시스템
• 워치 앱: Kotlin, Jetpack Compose for Wear OS
• 기기 간 통신: Wearable Data Layer API
• 백엔드(랭킹): AWS API Gateway + Lambda + DynamoDB (Ranking2048Table)
• 인증:
  • POST /ranking (v1) — 쿼리 파라미터 c에 CRC 체크섬
  • POST /ranking/v2, POST /ranking/name — X-Api-Key 헤더
  • DELETE /ranking — X-Admin-Secret-Key (관리자)

랭킹 API 요약

CRC 계산 (v1 호환)

def get_crc(point):
  res = point % 10 + point % 100 + point % 1000
  res += 31
  return res * res

DynamoDB 스키마 (Ranking2048Table)

• PK: period (ISO 주차, 예: 2025-W05)
• SK: sortKey (역순 점수 + 타임스탬프, 예: 999997952#2025-02-03T12:34:56)
• GSI: UniqueCheckIndex (period + uniqueKey, 중복 체크)
• 속성: name, country, code, point, play_time, user_id, account_type, ip, timestamp, uniqueKey(name#code#point)

프라이버시

GET 응답의 user_id는 앞 3글자만 노출되고 나머지는 * 마스킹. account_type은 GET 응답에 포함되지 않음.

아키텍처 요약

• Play Time 측정: 워치 화면이 켜져 있을 때만 카운트, SharedPreferences 저장, 1분 주기 UI 갱신 (게임 성능 방해 방지)
• 주간 랭킹: ISO 8601 주차 계산 (월요일 시작), period로 쿼리, sortKey로 자동 정렬 (점수 내림차순, 시간 오름차순)
• 월간 랭킹: 해당 월의 모든 주차 수집 → timestamp 기준 월 1일~말일 필터 → 점수 내림차순 정렬