Cube Eye

Drew Developer

Giới thiệu về trò chơi này

## 🚀 Tổng quan

**CubeEye** là một ứng dụng Android tiên tiến được thiết kế để giải khối Rubik 3x3. Ứng dụng sử dụng công nghệ thị giác máy tính để quét khối Rubik vật lý và cung cấp hướng dẫn 3D tương tác, hoạt hình để giải khối Rubik bằng các bước di chuyển gần tối ưu.

## ✨ Các tính năng chính

### 📷 Hệ thống quét thông minh

* **Phát hiện màu sắc theo thời gian thực:** Tự động nhận diện màu sắc các mặt khối Rubik bằng camera thông qua bộ phân tích màu tùy chỉnh `ColorAnalyzer`.

* **Quét có hướng dẫn:** Giao diện người dùng trực quan hướng dẫn người dùng thực hiện quy trình quét chính xác cả 6 mặt.

* **Logic xác thực:** Bộ xác thực `CubeValidator` tích hợp đảm bảo trạng thái được quét có thể giải được về mặt vật lý trước khi tiếp tục.

* **Hiệu chỉnh thủ công:** Bao gồm hộp thoại chọn màu `ColorPickerDialog` cho phép người dùng điều chỉnh màu sắc thủ công nếu điều kiện ánh sáng ảnh hưởng đến khả năng phát hiện tự động.

* ### 🧩 Bộ giải thông minh

* **Thuật toán Kociemba:** Tích hợp thuật toán Hai pha nổi tiếng (thông qua thư viện *min2phase*) để tìm ra các giải pháp gần tối ưu, thường chỉ cần ít hơn 20 bước di chuyển.

* **Tính toán cục bộ nhanh:** Giải quyết các khối rubik phức tạp trong vài giây trực tiếp trên thiết bị mà không cần kết nối mạng.

### 🎥 Hướng dẫn 3D tương tác

* **Hình ảnh 3D:** Có tính năng hiển thị 3D tương tác đầy đủ (`Cube3DView`) mô phỏng chính xác trạng thái của khối rubik thực.

* **Hoạt hình từng bước:** Người dùng có thể phát, tạm dừng và tua nhanh các bước giải theo tốc độ của riêng mình.

## 🛠 Điểm nổi bật về kỹ thuật

* **Nền tảng Android hiện đại:** Được xây dựng hoàn toàn bằng Kotlin và Jetpack Compose (Material 3).
* **Kiến trúc mạnh mẽ:** Tuân theo các nguyên tắc Kiến trúc sạch, sử dụng các mẫu MVVM, Hilt để tiêm phụ thuộc và Coroutines cho các hoạt động bất đồng bộ.

* **CameraX:** Triển khai nền tảng camera ổn định và hiệu quả để xem trước trực tiếp và phân tích hình ảnh.

* **SceneView:** Sử dụng thư viện SceneView để kết xuất 3D hiệu suất cao.

## 🐛 Các vấn đề đã biết / Việc cần làm

* Tối ưu hóa ngưỡng phát hiện màu sắc để xử lý tốt hơn các điều kiện ánh sáng khắc nghiệt.

* Tự động hóa việc tích hợp thư viện "min2phase" (hiện được bao gồm dưới dạng các tệp nguồn thủ công).

Tính năng mới

This is our very first release!