Cube Eye

Drew Developer

게임 소개

## 🚀 개요

**CubeEye**는 3x3 루빅 큐브를 풀도록 설계된 고급 안드로이드 애플리케이션입니다. 컴퓨터 비전 기술을 활용하여 실제 큐브를 스캔하고, 최적의 움직임에 가까운 3D 애니메이션 가이드를 통해 큐브를 풀 수 있도록 도와줍니다.

## ✨ 주요 기능

### 📷 스마트 스캐닝 시스템

* **실시간 색상 감지:** 맞춤형 `ColorAnalyzer`를 통해 카메라로 큐브 면의 색상을 자동으로 식별합니다.

* **가이드 스캔:** 직관적인 UI 오버레이를 통해 6개 면 모두를 정확하게 스캔할 수 있도록 안내합니다.

* **검증 로직:** 내장된 `CubeValidator`를 통해 스캔된 상태가 실제로 풀 수 있는 상태인지 확인한 후 다음 단계로 진행합니다.

* **수동 수정:** 조명 조건으로 인해 자동 감지가 어려울 경우, `ColorPickerDialog`를 사용하여 색상을 수동으로 조정할 수 있습니다.

### 🧩 지능형 해결사

* **코시엠바 알고리즘:** 유명한 2단계 알고리즘(min2phase 라이브러리 사용)을 통합하여 최적에 가까운 해를 찾아주며, 대개 20번 미만의 움직임으로 해결합니다.

* **빠른 로컬 연산:** 네트워크 연결 없이도 기기에서 직접 몇 초 만에 복잡한 스크램블을 해결합니다.

### 🎥 인터랙티브 3D 가이드

* **3D 시각화:** 실제 큐브의 상태를 정확하게 모방하는 완전한 인터랙티브 3D 렌더링(`Cube3DView`)을 제공합니다.

* **단계별 애니메이션:** 사용자는 원하는 속도로 해결 과정을 재생, 일시 정지 및 스크롤하여 볼 수 있습니다.

## 🛠 기술적 특징

* **최신 Android 스택:** Kotlin과 Jetpack Compose(Material 3)를 사용하여 완전히 개발되었습니다.

* **견고한 아키텍처:** 클린 아키텍처 원칙을 준수하며, MVVM 패턴, Hilt를 사용한 의존성 주입, 코루틴을 활용한 비동기 작업을 수행합니다.

* **CameraX:** 실시간 미리보기 및 이미지 분석을 위한 안정적이고 효율적인 카메라 기반을 구현합니다.

* **SceneView:** 고성능 3D 렌더링을 위해 SceneView 라이브러리를 사용합니다.

## 🐛 알려진 문제점 / TODO

* 극단적인 조명 조건을 더 잘 처리하도록 색상 감지 임계값을 최적화합니다.

* "min2phase" 라이브러리(현재 수동 소스 파일로 포함됨)의 통합을 자동화합니다.

새로운 기능

This is our very first release!