Nav Logo
Why Meta Quest?
Design
Develop
API reference
Distribute
Blog
Support
Login
Nav Logo
Build with Meta
Social Technologies
Meta Horizon
AI
Horizon Worlds
About us
Careers
Research
Products
Virtual reality / Meta Horizon
Developer Blog
Download SDKs
Meta for Work
Programs
Start
Meta Horizon Creator Program
Discover
Why Meta Quest?
What is mixed reality?
Platforms and tools
2D apps for Meta Horizon OS
Devices
Meta Avatars
Success stories
Use cases
Support and legal
Developer policies
Legal
Privacy
Forums
Support
Build with Meta
Social Technologies
Meta Horizon
AI
Horizon Worlds
About us
Careers
Research
Products
Virtual reality / Meta Horizon
Developer Blog
Download SDKs
Meta for Work
Programs
Start
Meta Horizon Creator Program
Discover
Why Meta Quest?
What is mixed reality?
Platforms and tools
2D apps for Meta Horizon OS
Devices
Meta Avatars
Success stories
Use cases
Support and legal
Developer policies
Legal
Privacy
Forums
Support
Build with Meta
Social Technologies
Meta Horizon
AI
Horizon Worlds
About us
Careers
Research
Products
Virtual reality / Meta Horizon
Developer Blog
Download SDKs
Meta for Work
Programs
Start
Meta Horizon Creator Program
Discover
Why Meta Quest?
What is mixed reality?
Platforms and tools
2D apps for Meta Horizon OS
Devices
Meta Avatars
Success stories
Use cases
Support and legal
Developer policies
Legal
Privacy
Forums
Support
English (US)
© 2025 Meta
Develop
Develop
Select your platform
Overview
OpenXR Mobile SDK
Overview
Basic Environment and Project Setup
System and Hardware Requirements
Device Setup
Android Development Software Setup
Android Studio Basics
Android Manifest Settings
Add a Splash Screen
Native Android Mixed Reality Capture
Set Display Refresh Rates
OpenXR Support Overview for Meta Quest Headsets
OpenXR Support for Meta Quest Headsets
Build and Run hello_xr Sample App
Native OpenXR Samples
OpenXR Core Concepts
Core Concepts
Creating Instances and Sessions
Collecting System Information
Input API
Creating Actions, Action Sets, and Suggested Bindings
Creating and Using Swapchains
Synchronizing and Submitting Frames
Mixed Reality Experience and Use Cases
OpenXR Meta Extensions
Passthrough
Overview
Customize Passthrough
Loading Screen
Passthrough over Link
Best Practices
Depth
Overview
Movement
Overview
Body Tracking
Face Tracking
Eye Tracking
Blendshape Visual Reference
Body Joints Visual Reference
API Reference
Scene
Overview
Best Practices
API Reference
Spatial Anchors
Overview
Developer Environment Setup
Features and Lifecycle
API Reference
Sample Apps
Space Sharing
Overview
API Reference
Sample Apps
Colocation Discovery
Overview
API Reference
Sample Apps
Virtual Keyboard
Overview
glTF Requirements
Native Integration
Sample Project
Dynamic Object Tracking
Haptic Feedback
Microgestures
Bicubic Filtering with OpenXR
Composition Layer Filtering
Application SpaceWarp Developer Guide
Enable Hand Tracking
Use Capsense
Use Wide Motion Mode
Use Multimodal
Testing and Troubleshooting
Screenshots and Video Capture
Wired Monitoring with ADB
MSAA Analysis for Meta Quest
Android Debugging and Performance Analysis
SysTrace
Native Debugging
Native Debugging with Android Studio
Native Debugging with ndk-gdb
Developer Tools
Meta Quest Developer Hub
Overview
Getting Started
Set Up Headset with MQDH
Managing Your Headset
Debugging Tools
Create Custom Command
Performance Analyzer and Metrics
Overview
How to Take Perfetto Traces
Layer Visibility Control
Explore File Manager
Add, Remove, and Switch Between Multi-User Accounts
MQDH Downloads
Deploy Build on Headset
Troubleshooting MQDH
Submit and Track Bugs and Feature Requests
Android Tools
Collect VrApi Logs with Logcat
Overview
Logcat Stats Definitions
Configure Android System Properties on Meta Quest
Use ADB with Meta Quest
Performance Tools
RenderDoc Meta Fork
Overview
Taking and Loading a Capture
Performing a Render Stage Trace
Performing a Draw Call Trace
Accessing Vulkan Shader Stats
Recommended Settings
Draw Call Metrics
OVR Metrics Tool
Overview
OVR Metrics Tool Stats Definition Guide
Best Practices - OVR Metrics Tool for Non-Engineers
gpumeminfo
ovrgpuprofiler
Simpleperf
Testing and Automation Tools
Use Meta Quest Scriptable Testing Services to Enable E2E Testing
Using AutoDriver to Record Inputs
Using Oculus Debugger for VS Code
Vulkan Validation Layers
Performance and Optimization Guides
Overview
Operating system
CPU and GPU levels
OpenXR, VRAPI, and LibOVR
OpenGL ES and Vulkan
Compatibility mode
Graphics subsystems
Render Scale
Fixed Foveated Rendering (FFR)
App spacewarp
Compositor
Compositor layers
Graphics architecture
Mobile GPUs and tiled rendering
Mobile GPUs and improved algorithms
Mobile GPUs and impaired algorithms
Boosting CPU and GPU Levels
Accurately Measure an App's Per-Frame GPU Cost
Advanced GPU Pipelines and Loads, Stores, and Passes
Art Direction for All-in-One VR Performance
Basic Optimization Workflow for Meta Quest Apps
Using RenderDoc Meta Fork to Optimize Your App - Part 1
Using RenderDoc Meta Fork to Optimize Your App - Part 2
PC SDK
Overview
PC SDK Getting Started Guide
Getting Started with the SDK
Oculus Rift SDK Setup
Getting Started with the Demos
Launching Third-Party Applications
PC SDK Developer Guide
LibOVR Integration
Initialization and Sensor Enumeration
Rendering to the Oculus Rift
Advanced Rendering Configuration
Oculus Dash
VR Focus Management
Guardian System
Touch Plus Controllers
Rift Audio
Rift Touch Controllers
Controllers Overview
Controller Data
Controller Tracking
Button State
Button Touch State
Haptic Feedback
Oculus Avatars
Overview
Native C/C++ Mirror Sample Guide
Avatar SDK C/C++ Developer Reference
SDK Samples and Gamepad Usage
Oculus Debug Tool
Optimizing Your Application
VR Performance Optimization Guide
Overview
Guidelines for VR Performance Optimization
Workflows: The process flows you should follow
Performance Optimization Tools
Tutorial: Optimizing a Sample Application
Additional Resources
Lost Frame Capture Tool
SDK Performance Statistics
Performance Profiler
Performance Head-Up Display
Performance Indicator
Compositor Mirror
Pairing the Oculus Touch Controllers
Asynchronous SpaceWarp
Mixed Reality Capture
OpenXR Support for PC Development
Reference Content
Developer Reference
Troubleshooting
Platform Solutions
Overview
Get Started
Multiplayer Enablement
Getting Started Guide
Server-to-Server API Basics
Request and Messages
Set Up for Platform Development
Multiplayer Features
Multiplayer Overview
Multiplayer Enablement
Travel Features
Travel Overview
Destinations
Group Presence
Invite to App
Testing and Use Cases
Invite Link
Quick Invites
App to App Travel
Roster
Rejoin
Invokable Error Dialogs
SharedSpaces Multiplayer Showcase
Test Cases
User Engagement
User Engagement Overview
User Notifications
Overview
Create User Notifications
Event-Based Notifications
Analytics
Developer Posts
Leaderboards
Leaderboard Client APIs
Leaderboard Server APIs
Events
Achievements
Challenges
Challenges Client APIs
Challenges Server APIs
Share Content from Meta Apps
Monetization
Monetization Overview
Add-ons - Downloadable Content and In-App Purchases
Add-ons Integration
Add-ons Server APIs
Testing Add-ons
Subscriptions
Server APIs for Subscriptions
Social Features
Social Features Overview
Blocking
Parties and Party Chat
Parties and Party Chat
Mic Switcher
User Info, Friends and Relationships
Overview
Verify the User
Enable Friend Requests (Mobile)
Managed Accounts
Managed Account API Overview
User Management
User Management Overview
Entitlement Check
Account Linking
Language Packs
Security
Security Overview
Attestation API
Get Age Category API
Accessibility
Lying Down Mode
Quest Tools
Quest Tools
Asset Files to Manage Download Size
App Deep Linking
System Deep Linking
Cloud Storage
Cloud Backup
Save Game Best Practices
Cross-Device Development with App Groupings
Webhooks
Sample Apps
Platform Reference
Platform Release Notes Archive
Deprecated Features
Matchmaking (Deprecated)
Introduction to Matchmaking (Deprecated)
Matchmaking API (Deprecated)
Implement Matchmaking (Deprecated)
Refine Matchmaking (Deprecated)
Test and Tune Matches (Deprecated)
Peer-to-Peer Networking (Deprecated)
Rooms (Deprecated)
Rooms Client APIs (Deprecated)
Server APIs for Moderated Rooms (Deprecated)
Voice Chat (VoIP) (Deprecated)
Meta XR Simulator
Introduction
Getting Started
Interaction Simulation
Simulate User Input from Keyboard, Mouse, and Xbox Game Controllers
Simulate User Input from Meta Quest Controllers
Simulate a Mixed Reality Environment
Test Rooms
Overview
Built-in Rooms
Build your room in the Synthetic Environment Builder
Build your room in JSON
Overview
Exporting rooms from headset
Room JSON Syntax
Record and Replay
Multiplayer Testing
Automated Testing
Body Tracking
Hand Tracking
Logs
Experimental Features
Manage experimental features
Mobile experimental features
Haptics Native SDK
Overview
Get Started
Add Haptics
MediaProjection
Passthrough Camera
Overview
Android Native Camera2 API
Location-aware Apps
Spatial Data Permission
Archive
Overview
VrApi (Deprecated)
VrApi Native Developer Guide (Deprecated)
VrApi Native Development Overview (Deprecated)
VrApi Native Samples (Deprecated)
Reserved User Interactions (Deprecated)
Oculus Avatars (Deprecated)
Overview (Deprecated)
Native Mirror Sample Guide (Deprecated)
Avatar SDK Developer Reference (Deprecated)
VrApi Native Engine Integration (Deprecated)
VrApi Fundamentals (Deprecated)
VrApi Input API (Deprecated)
Enable Focus Awareness (Deprecated)
Keyboard Overlay Integration (Deprecated)
Enable Phase Sync (Deprecated)
Set Color Space (Deprecated)
Guardian System (Deprecated)
Asynchronous TimeWarp (ATW) (Deprecated)
Power Management (Deprecated)
Advanced Rendering (Deprecated)
Multi-View (Deprecated)
Fixed Foveated Rendering (Deprecated)
VrApi Developer Release Guide (Deprecated)
Overview (Deprecated)
Mobile Native SDK Migration Guide (Deprecated)
Oculus VST Spatializer for DAWs Integration Guide (Retired)
Overview (Retired)
Use the Oculus Plugin (Retired)
VST Options and Parameters (Retired)
3D Visualizer (Retired)
DAW-Specific Notes (Retired)
Legal Notifications (Retired)
Oculus AAX Spatializer for DAWs Integration Guide (Retired)
Overview (Retired)
Use the Plugin (Retired)
Track Parameters (Retired)
3D Visualizer (Retired)
Archived Platform Solutions
Matchmaking (Deprecated)
Introduction to Matchmaking (Deprecated)
Matchmaking API (Deprecated)
Implement Matchmaking (Deprecated)
Refine Matchmaking (Deprecated)
Test and Tune Matches (Deprecated)
Peer-to-Peer Networking (Deprecated)
Group Launch (Deprecated)
Rooms (Deprecated)
Rooms Client APIs (Deprecated)
Server APIs for Moderated Rooms (Deprecated)
Voice Chat (VoIP) (Deprecated)
Oculus Audio for Native Apps
Overview
Oculus Spatializer Features
Oculus Spatializer for Wwise
Set Up the Oculus Spatializer for Wwise
How to Use the Oculus Spatializer for Wwise
Integrate the Oculus Spatializer in Your App
Oculus Spatializer for FMOD Integration Guide
Set Up the Oculus Spatializer for FMOD
How to Use the Oculus Spatializer and Ambisonics in FMOD Studio
Oculus Spatial Reverb
Oculus Lipsync Development Guide
Overview
Viseme Reference
Native Development Using Oculus Lipsync
Explore Oculus Lipsync with the Sample Scene for Native
Oculus Lipsync Native Reference
Oculus Audio Profiler
Overview
Setup the Profiler
Profile Spatialized Audio
Oculus Audio Loudness Meter
Overview
Setup the Loudness Meter
Measure Loudness
Audio Developer Reference
Archived Developer Tools
GPU Systrace (Deprecated)
Cloud Saves API (Deprecated)
Cloud Saves Deprecation
Tracked Keyboard (Deprecated)
Physical Keyboard Tracking Integration (Deprecated)
Using Keyboard Tracking Sample (Deprecated)
Code samples
Downloads
Release notes
Supported platforms
Native and OpenXR
PC SDK
​
Back to Native and OpenXR
Controller Data
The Oculus SDK provides APIs that return the position and state for each Rift Touch controller.
This data is exposed through two locations:
  • ovrTrackingState::HandPoses[2]: Returns the pose and tracking state for each Rift Touch controller.
  • ovrInputState: The structure returned by ovr_GetInputState that contains the Rift Touch button, joystick, trigger, and capacitive touch sensor state.
The controller hand pose data is separated from the input state because it comes from a different system and is reported at separate points in time. Controller poses are returned by the constellation tracking system and are predicted simultaneously with the headset, based on the absolute time passed into GetTrackingState. Having both hand and headset data reported together provides a consistent snapshot of the system state.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon