Webcam Runner

March 14, 2025 · View on GitHub

中文说明

Webcam Runner

A running game based on webcam, controlling the game character in an infinite scene by detecting user movements. Now with AI Companion providing real-time movement guidance and personalized feedback. Main technologies: Three.js, MediaPipe Pose

Technical Architecture

Core Frameworks

  • Three.js: For 3D scene rendering
    • Infinite terrain generation
    • Scene object handling
    • Camera animation management
  • MediaPipe Pose: For motion detection
    • Supports full-body/half-body recognition
    • Real-time pose estimation
    • Keypoint tracking
    • User distance detection (supports close-range mode)
    • Movement intensity calculation (based on user weight)

Features

Current Features

  1. AI Running Companion

    • Real-time movement guidance
    • Personalized feedback system
    • Adaptive difficulty adjustment
    • Exercise intensity monitoring
  2. Motion Detection System

    • Supports full-body/half-body detection
    • Real-time motion analysis
    • Intelligent movement judgment
    • User distance detection (supports close-range mode)
    • Movement intensity calculation (based on user weight)
  3. Basic 3D Scene

    • Infinite terrain generation
    • Basic scene objects
    • Dynamic camera system

System Requirements

  • Processor: Intel i3 or equivalent (recommended with AVX instruction set)
  • Webcam: Supports 720p resolution
  • Browser: Latest version of Chrome or Edge (Chrome recommended for best MediaPipe performance)
  • Memory: 4GB RAM+
  • Graphics: Supports WebGL 2.0 (e.g., Intel HD Graphics 4000 or higher)

Installation and Running

  1. Clone the project
  2. Open index.html in the browser
  3. Allow camera access

License

GNU General Public License v3.0 所有代码,包括历史记录,应视为受GPLv3约束

If you find this project useful, you can buy me a coffee:

paypal afdian.com Alipay QR Code WeChat QR Code