Develop

Move Fast sample overview

Updated: May 10, 2026

Overview

Move Fast is a VR fitness boxing game built with the Meta XR Interaction SDK. It demonstrates hand tracking, pose detection, velocity-based interactions, and timeline-driven choreography for an engaging workout experience.

Key features

FeatureImplementationDescription
Hand tracking
IHand interface + CompoundHandRef
Robust hand input with fallback support
Pose detection
ShapeRecognizer + TransformRecognizerActiveState
Recognizes Fist, Chop, and Palm poses
Velocity tracking
12-sample circular buffer
Capped at 6.8 m/s for consistent gameplay
Choreography
Timeline with custom MarkerTrack
Drives beat-synced boxing sequences
State machine
StringPropertyBehaviour
Reactive state management

Architecture

  • Meta XR Interaction SDK for hand input via IHand interface and CompoundHandRef
  • ShapeRecognizer detects three core poses:
    • Fist
    • Chop
    • Palm
  • TransformRecognizerActiveState combines shape and transform data for pose activation
  • Velocity tracking uses a 12-sample circular buffer capped at 6.8 m/s
  • Timeline-driven choreography with custom MarkerTrack for beat sequencing
  • Reactive state machine using StringPropertyBehaviour

Pose detection pipeline

// ShapeRecognizer defines finger curl/spread thresholds
// TransformRecognizerActiveState combines shape + spatial checks
ShapeRecognizer fistRecognizer; // all fingers curled
ShapeRecognizer chopRecognizer; // fingers extended, hand edge forward
ShapeRecognizer palmRecognizer; // fingers extended, palm facing target

Requirements

  • Quest with hand tracking enabled
  • Unity 2022.3.22f1
  • Android build target
  • Meta XR SDK v68

Getting started

git clone https://github.com/oculus-samples/Unity-MoveFast.git
  1. Open the project in Unity 2022.3.22f1
  2. Switch platform to Android
  3. Ensure Meta XR SDK v68 is installed
  4. Enable hand tracking in Quest settings
  5. Build and deploy to Quest