🏋️‍♂️ Exergame basé sur la vision par ordinateur et Unity

Ce dépôt présente un prototype d’exergame combinant vision par ordinateur (Python) et jeu vidéo 3D (Unity). Le joueur contrôle son personnage uniquement par des mouvements corporels, détectés en temps réel via la webcam.

Les deux vidéos associées au projet illustrent :

• 🔍 la détection et l’analyse des mouvements (Python),
• 🎮 leur intégration interactive dans un jeu Unity.

---

🎯 Objectifs du projet

• Développer une interface corps–jeu sans manette ni capteur externe
• Reconnaître automatiquement des exercices de musculation
• Compter les répétitions en temps réel
• Rendre l’activité physique ludique, accessible et motivante

Ce projet s’inscrit à l’intersection de :

• la vision par ordinateur,
• les sciences du mouvement,
• le jeu sérieux (serious game),
• la santé et la rééducation.

---

🧠 Partie 1 – Analyse du mouvement (Python)

La première vidéo montre le pipeline de traitement côté Python :

Fonctionnalités

• Détection du squelette en temps réel via webcam

• Estimation des angles articulaires (ex. coude)

• Reconnaissance d’exercices :

  • Curl
  • Shoulder press
  • Squat

• Comptage automatique des répétitions

• Affichage temps réel :

  • squelette
  • angles
  • compteur par exercice

Technologies utilisées

• Python
• OpenCV
• MediaPipe (pose estimation)
• NumPy

Logique principale

1. Acquisition vidéo
2. Estimation de la pose
3. Calcul des angles articulaires
4. Détection de phases concentrique / excentrique
5. Incrémentation des répétitions
6. Envoi des événements vers Unity

---

🎮 Partie 2 – Jeu Unity (Exergame)

La seconde vidéo présente le jeu développé sous Unity :

Concept du jeu

• Le joueur incarne un personnage avançant sur une plateforme

• Chaque exercice déclenche une action :

  • Curl → action 1
  • Press → action 2
  • Squat → action 3

• Les répétitions validées font progresser le personnage

Fonctionnalités

• Environnement 3D stylisé
• Feedback visuel immédiat
• Score et progression
• Contrôle 100 % corporel

Technologies utilisées

• Unity (C#)
• Communication temps réel avec Python (socket/UDP)

---

🔗 Communication Python ↔ Unity

• Les événements détectés (type d’exercice, répétition validée) sont transmis de Python vers Unity via connexion UDP
• Unity interprète ces signaux pour déclencher les actions du jeu

---

🚀 Installation & Lancement

Prérequis

• Python ≥ 3.9
• Webcam
• Unity Hub + version Unity recommandée

Unity

• Lancer le scipt python ExcerciseDetector.py
• Lancer la scène principale

---

🧪 État du projet

✅ Prototype fonctionnel

🔧 Améliorations possibles :

• Calibration personnalisée par utilisateur
• Ajout d’exercices
• Niveaux de difficulté
• Analyse biomécanique avancée
• Intégration VR / AR

---

🤝 Contributions

Les contributions sont bienvenues :

• amélioration du modèle de détection
• gameplay
• UX / UI
• optimisation des performances

N’hésitez pas à ⭐ le dépôt si le projet vous inspire !