🎮 Translator Voice AR Game

Прототип веб-игры для изучения иностранных слов с элементами дополненной реальности (AR) и голосовым управлением.

Игрок видит слово на русском языке и должен произнести его перевод на английском. При правильном ответе персонаж бежит вперед по 3D-дороге к следующему уровню.

✨ Особенности

• AR-режим: Фон игры — это изображение с вашей веб-камеры.
• Голосовое управление: Используется нейросеть OpenAI Whisper (Large v3 Turbo) через Hugging Face Inference API для точного распознавания речи.
• 3D-графика: Визуализация на базе Three.js (бесконечная дорога, ворота, анимированные 3D-аватары из эмодзи).
• Игровая механика: Прохождение уровней, анимация "раннера", эффекты частиц (салюты).

🛠 Технологический стек

• Backend: Python 3.10+, FastAPI.
• Frontend: HTML5, CSS3, JavaScript (Vanilla), Three.js (через CDN).
• AI/ML: Hugging Face Inference API.
• Audio: Pydub (для конвертации WebM -> FLAC).

🚀 Установка и запуск

Предварительные требования

1. Python 3.10+
2. FFmpeg: Необходим библиотеке pydub для обработки аудио.
   • Windows: Скачайте build, добавьте папку bin в системную переменную PATH.
   • Linux: sudo apt install ffmpeg
   • MacOS: brew install ffmpeg

Шаг 1: Клонирование и зависимости

# Клонируйте репозиторий (если есть) или перейдите в папку проекта
cd TranslatorVoiceGame

# Создайте виртуальное окружение
python -m venv venv

# Активируйте окружение
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Установите зависимости
pip install -r requirements.txt

Шаг 2: Настройка API ключа

Для работы распознавания речи нужен токен Hugging Face (бесплатный).

1. Зарегистрируйтесь на huggingface.co.
2. Создайте токен доступа (Access Token) в настройках профиля (тип Read).
3. Создайте файл .env в корне проекта и добавьте туда токен:

HF_TOKEN=hf_ВашТокенЗдесь

Шаг 3: Запуск

python main.py

Сервер запустится по адресу: http://localhost:8000

🎮 Как играть

1. Откройте http://localhost:8000 в браузере.
2. Разрешите доступ к микрофону и камере.
3. Посмотрите на слово в верхней части экрана (например, "кошка").
4. Нажмите красную кнопку "ГОВОРИТЬ" (она изменится на "СТОП").
5. Четко произнесите перевод на английском (например, "Cat").
6. Нажмите кнопку "СТОП".
7. Если ответ верный — вы побежите к следующему уровню!

📂 Структура проекта

• main.py — Серверная часть (FastAPI), обработка аудио, API Hugging Face.
• static/
  • index.html — Верстка приложения.
  • app.js — Логика игры, 3D-сцена (Three.js), запись звука.
• requirements.txt — Список Python-зависимостей.

---

Прототип разработан с помощью AI-ассистента.