Cube Eye

Drew Developer

Ойын туралы ақпарат

## 🚀 Шолу

**CubeEye** - 3x3 Рубик кубиктерін шешуге арналған кеңейтілген Android қолданбасы. Ол физикалық кубикті сканерлеу үшін компьютерлік көруді пайдаланады және оны оңтайлы дерлік қозғалыстар арқылы шешуге арналған интерактивті, анимациялық 3D нұсқаулықты ұсынады.

## ✨ Негізгі мүмкіндіктері

### 📷 Ақылды сканерлеу жүйесі

* **Нақты уақыттағы түстерді анықтау:** Арнайы `ColorAnalyzer` арқылы камераны пайдаланып, куб бетінің түстерін автоматты түрде анықтайды.
* **Бағытталған сканерлеу:** Интуитивті интерфейс қабаттамасы пайдаланушыларға барлық 6 бетті дұрыс түсіру процесінде бағыт береді.
* **Тексеру логикасы:** Кіріктірілген `CubeValidator` сканерленген күйдің жалғастырмас бұрын физикалық түрде шешілетінін қамтамасыз етеді.
* **Қолмен түзету:** Жарықтандыру жағдайлары автоматты анықтауға әсер етсе, пайдаланушыларға түстерді қолмен реттеуге мүмкіндік беретін `ColorPickerDialog` қамтиды.

### 🧩 Ақылды шешім

* **Косиемба алгоритмі:** Оңтайлы шешімдерді табу үшін әйгілі екі фазалы алгоритмді (*min2phase* кітапханасы арқылы) біріктіреді, көбінесе 20-дан аз қадамды қажет етеді.
* **Жылдам жергілікті есептеу:** Желіге қосылуды қажет етпей, құрылғыда күрделі скребтерді бірнеше секунд ішінде шешеді.

### 🎥 Интерактивті 3D нұсқаулық

* **3D визуализация:** Нақты текшенің күйін дәл имитациялайтын толық интерактивті 3D рендеринг (`Cube3DView`) бар.
* **Қадамдық анимация:** Пайдаланушылар шешім қадамдарын өз қарқынымен ойната, кідірте және өңдей алады.

## 🛠 Техникалық ерекшеліктері

* **Заманауи Android Stack:** Толығымен Kotlin және Jetpack Compose (Material 3) көмегімен жасалған.
* **Берік архитектура:** MVVM үлгілерін, тәуелділік инъекциясы үшін Hilt және асинхронды операциялар үшін Coroutines пайдалана отырып, таза архитектура принциптерін ұстанады.
* **CameraX:** Тікелей алдын ала қарау және кескінді талдау үшін тұрақты және тиімді камера негізін енгізеді.
* **SceneView:** Жоғары өнімді 3D рендеринг үшін SceneView кітапханасын пайдаланады.

## 🐛 Белгілі мәселелер / TODO

* Шамадан тыс жарық жағдайларын жақсырақ басқару үшін түстерді анықтау шектерін оңтайландырыңыз.
* "min2phase" кітапханасының интеграциясын автоматтандырыңыз (қазіргі уақытта қолмен бастапқы файлдар ретінде қосылған).

Жаңа функциялар

This is our very first release!