Meta Developers

Why Meta Quest?

Login

Develop

Develop

Developing Apps for Horizon OS

Set Up Your Device

Explore Features with Building Blocks

Simulate Builds with XR Simulator

Add User Input and Interactions

Meta XR Core SDK

Meta XR Core SDK Overview

Meta XR Core SDK Samples

Interaction SDK Overview

Get Started with Interaction SDK

Add an Interaction with Quick Actions

Use Interaction SDK with Unity XR

OpenXR Hand Skeleton

OpenXR Upgrade Dialog

Upgrade Custom Components

The Cameraless Rig Prefab

Use Custom Hand Models

ComprehensiveRigExample Scene

ConcurrentHandsControllersExamples Scene

Interactor Interactable Lifecycle

Interactor Groups

Use Active State

Pointer Lifecycle

Grabbing Objects

Controller Grab

Grab with Controller Driven Hands

HandGrabExamples Scene

Grab Best Practices

Grab Troubleshooting

Distance Hand Grab

Distance Controller Grab

Distance Grab with Controller Driven Hands

Create Ghost Reticles

DistanceGrabExamples Scene

Touch Hand Grab

TouchGrabExamples Scene

Snapping Objects

Snap Interactions

Create Snap Interactions

SnapExamples Scene

HandGrabUseExamples Scene

TransformerExamples Scene

Create a Hand Grab Pose (PC)

Create a Hand Grab Pose (Mac)

Movement Providers

Physics Components

Poke Interactions

PokeExamples Scene

Ray Interactions

RayExamples Scene

Moving in the World

Locomotion Overview

Teleport Interactions

Turn Interactions

Slide Interactions

Step Interactions

Gating Locomotion

Microgestures for Locomotion

Locomotion Events

Create Locomotion Interactions

Character Controllers for Locomotion

Locomotion Comfort

LocomotionExamples Scene

Unity Canvas Integration

Detecting Poses

Build Custom Hand Pose

Hand Pose Selector Recorder

Hand Pose Detection

Body Pose Detection

Compare Body Poses

PoseExamples Scene

GestureExamples Scene

BodyPoseDetectionExamples Scene

Handling Events

Secondary Interactions

Working with Hands

Hand Physics Capsules

Get Hand Bone Position

Body, Face, and Eye Tracking

Getting Started

Natural Facial Expressions

Body Tracking Samples

Natural Facial Expressions and Eye Tracking Samples

Advanced Samples

Advanced Material

Scripts and Shaders

Troubleshooting

Tracked Keyboard

Tracked Keyboard with Interaction SDK Sample

Integrating Voice SDK

Enable App Voice Experiences with Built-In NLP

Add Voice Experiences with Custom NLP

Add Live Understanding to Your App

Providing Voice Transcriptions

Providing Visual Feedback

Live Understanding

Built-in Intents

Built-in Entities

Built-in Traits

Dynamic Entities

Implementing Dynamic Entities

Dynamic Entities Based on GameObject Lifecycle

Supporting Oculus Parties

Text-to-Speech (TTS)

TTS Voice Customization

TTS Cache Options

Preloading TTS Files

Key Components of Composer

Creating a Composer-based Scene

Tutorial - Receive Basic Voice Input

Feature Walkthrough

Troubleshooting

Troubleshooting

Other Runtime APIs

Customize inputs and animations

Getting Started with Controller Input and Tracking

Render Controllers at Runtime

Touch Pro Controllers

Touch Plus Controllers

Add Controller Animations

Troubleshooting

Interactions Setup

Wide Motion Mode

Fast Motion Mode

Troubleshooting and Limitations

Unity Spatializer Plugin

Requirements and Setup

Getting Started Tutorial

Samples Overview

Ambisonics Tutorial

Troubleshooting

FMOD Spatializer Plugin

Getting Started

Troubleshooting

Wwise Sink Plugin

Getting Started

Unity Integration

Parameter Reference

Troubleshooting

Acoustic Ray Tracing

Getting Started

Project Settings

Troubleshooting

Mixed Reality Utility Kit

Placing Content in Your Space

Scene Understanding

Managing the Scene using MRUK

Working with Scene Data

Visualizing the Scene

Environment Raycasting

Dynamic Spawning

Navigating in the Scene

Having Fun with Destructible Mesh

Using the SpaceMap

Decorating the Room

Testing your Implementation

Passthrough Relighting Sample

Passthrough Over Link

Passthrough Styling

Color Mapping Techniques

Create Color LUTs

Neutral Color LUTs

Compositing and Masking

Passthrough Windows

Surface Projected Passthrough

Basic Tutorial with Building Blocks

Passthrough Window Tutorial

Color LUT Tutorial

Projected Passthrough Tutorial

Passthrough with Multiple Features

Overlay Passthrough

Additional Resources

Troubleshooting

Create Depth Perception

Samples and Support

Unity’s XR.Oculus Usage

Troubleshooting and FAQ

Spatial Data Permission

Use the Scene Model

Access Scene data with OVRAnchor

Mixed Reality Sample

Custom Scene Manager Sample

Troubleshooting

Migrate to MR Utility Kit

Get Started with OVRSceneManager

Use OVRSceneManager

Plane and Volume Sample

Use Spatial Anchors

Getting Started

Spatial Anchors

Shared Spatial Anchors

Shared Spatial Anchors Sample

Shared Spatial Anchors Troubleshooting

Use Space Sharing

Getting Started

Passthrough Camera

Implementation using WebCamTexture

Colocation Discovery

Mixed Reality Experience and Use Cases

Asynchronous Tasks

Platform Solutions

Getting Started Guide

Set Up for Platform Development

Set Up Platform Entitlements

Server-to-Server API Basics

Multiplayer Features

Multiplayer Overview

Multiplayer Enablement

Multiplayer Building Blocks

Testing and Use Cases

App to App Travel

Invokable Error Dialogs

Networking with Photon

SharedSpaces Multiplayer Showcase

Multiplayer Testing

Multiplayer Testing with Quest Link

Multiplayer Testing with Quest Link and Meta XR Simulator

Multiplayer Testing Tool

User Engagement

User Engagement Overview

User Notifications

Create User Notifications

Event-Based Notifications

Developer Posts

Leaderboards Client APIS

Leaderboard Server APIs

Challenges Client APIs

Challenges Server APIs

Share Content from Meta Quest Apps

Monetization Overview

Add-ons - DLC and IAP

Add-ons Purchase Integration

Add-ons Server APIs

Testing Add-ons

Server APIs for Subscriptions

Social Features

Social Features Overview

Parties and Party Chat

Parties and Party Chat

User Info, Friends and Relationships

Verify the User

Enable Friend Requests (Mobile)

Managed Accounts

Managed Account API Overview

User Management

User Management Overview

Entitlement Check

Cross-Play with Federated Authentication

Create Federated User

Delete Federated User

Generate Federated User Access Token

Read Federated User

Read Federated Users

Update Federated User

Account Linking

Security Overview

Attestation API

Get Age Category API

Lying Down Mode

Quest Tools Overview

App Deep Linking

System Deep Linking

In App Update APIs

Asset Files to Manage Download Size

Save Game Best Practices

Cross-Device Development with App Groupings

Platform Reference

Platform Release Notes Archive

Integrate Meta Avatars

Configure Unity Project

Upgrade Guide to V29+

Avatars SDK Manager Prefab

Avatars Editor Integration

OvrAvatarEntity

Loading Avatars

Avatar Input Tracking

Custom Hand Poses

Custom Input Handling

Adding Face and Eye Pose

Networking Avatars

Socket Attachables

Enhance the User Interface

Camera Features

Configure Meta XR Camera Settings

Add a Splash Screen

Mixed Reality Capture

Spectator Camera for Casting

The Boundary System

Create Interactive Boundaries

Enable Focus Awareness

Enable System Keyboard Overlay

Oculus Dash in Unity

Display and Rendering Capabilities

Fixed Foveated Rendering

Eye Tracked Foveated Rendering

Set Display Refresh Rates

Enable Phase Sync

Enable Multiview

Enable Late Latching

VR Compositor Layers

Single Pass Stereo Rendering and Stereo Instancing

Set Specific Color Space

Asymmetric FOV FAQ

Application SpaceWarp Developer Guide

Forward+ Rendering

Vulkan Subpasses

Performance and Optimization

Testing and Performance Analysis

Operating system

CPU and GPU levels

OpenXR, VRAPI, and LibOVR

OpenGL ES and Vulkan

Compatibility mode

Graphics subsystems

Fixed Foveated Rendering (FFR)

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

Basic Optimization Workflow for Meta Quest Apps

Draw Call Cost Analysis for Meta Quest

Dynamic Resolution

Open World Games and Asset Streaming

Unity Iteration Speed Best Practices

Using RenderDoc Meta Fork to Optimize Your App - Part 1

Using RenderDoc Meta Fork to Optimize Your App - Part 2

Project Configuration

Build Configuration

Optimize Build Iterations and Use Quick Scene Preview

Strip Unused Shaders

Cubemap Screenshots

Cross-Platform Development

Application lifecycle handling

Use Meta Quest Scriptable Testing Services to Enable E2E Testing

Using AutoDriver to Record Inputs

Vulkan Validation Layers

Developer Tools

Meta XR Packages

In-Editor Tools

Project Setup Tool

XR Plugin Management

Building Blocks

Immersive Debugger

HMD Motion Emulation

Meta Quest Developer Hub

Manage Your Headset

Set Up Headset with MQDH

Debugging Tools

Create Custom Command

Performance Analyzer and Metrics

How to Take Perfetto Traces

Layer Visibility Control

Explore File Manager

Add, Remove, and Switch Between Multi-User Accounts

Deploy Build on Headset

Troubleshooting MQDH

Submit and Track Bugs and Feature Requests

Meta XR Simulator

Interaction Simulation

Simulate User Input from Keyboard, Mouse, and Xbox Game Controllers

Simulate User Input from Meta Quest Controllers

Simulate a Mixed Reality Environment

Build your room in the Synthetic Environment Builder

Build your room in JSON

Exporting rooms from headset

Room JSON Syntax

Record and Replay

Multiplayer Testing

Automated Testing

Zero-code Automation Testing

Programmatic Automation Testing

Hybrid Automation Testing

Test App with Different Room Layouts (Synthetic Environments)

Automate Multiplayer Testing

Collect VrApi Logs with Logcat

Logcat Stats Definitions

Configure Android System Properties

Android Debug Bridge for Meta Quest

Performance Tools

RenderDoc Meta Fork

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

OVR Metrics Tool Stats Definition Guide

Best Practices - OVR Metrics Tool for Non-Engineers

Publish Your App

Prepare Your App for Publishing

Generate the Android Manifest File

Upload App from Unity

Sample Projects

UPM Package Samples

Starter Samples

CustomControllers

Overlay Passthrough

Shared Spatial Anchors

Spatial Anchors

Mixed Reality Motifs

Mixed Reality Motifs Overview

Passthrough Transitioning

Shared Activities in Mixed Reality

Instant Content Placement

SharedSpaces Showcase

Social Game Showcase

Discover Showcase

Set up the Colocation Package

Deep Dive into the Colocation Package

Scene Integration in DroneRage

Passthrough API in DroneRage

Interaction SDK Integration in DroneRage

Discover and DroneRage FAQ

Import Oculus Integration SDK (Legacy)

Oculus Integration SDK Sample Framework (Legacy)

Interaction SDK Tutorials (Legacy)

Create Grab Interactions

Create Distance Grab Interactions

Create Poke Interactions

Create Ray Interactions

Use Ray Interaction with UI

Throw an Object

Oculus Audio SDK (EOL)

Oculus Spatializer Features

Oculus Native Spatializer

Requirements and Setup

Explore Sample Scene

Apply Spatialization

Dynamic Room Modeling

Play Ambisonic Audio

Audio Propagation (Beta)

Manage Sound Effects with Oculus Audio Manager

Oculus Spatializer for Wwise

Set Up Oculus Spatializer for Wwise

Use Oculus Spatializer for Wwise

Configure Target Platforms for Wwise

Integrate Oculus Spatializer

Oculus Spatializer for FMOD Integration

Set Up Oculus Spatializer for FMOD

Use Oculus Spatializer and Ambisonics in FMOD Studio

Oculus Spatial Reverb

Install with FMOD Studio Unity Integration

Viseme Reference

Use Oculus Lipsync

Precompute Visemes to Save CPU

Explore Sample Scene

Oculus Audio Profiler

Set up Profiler

Profile Spatialized Audio

Oculus Audio Loudness Meter

Set up Loudness Meter

Measure Loudness

Meta Avatars SDK Quest 1 Support (Retired)

Oculus VST Spatializer for DAWs Integration (Retired)

Oculus VST Spatializer for DAWs Integration Guide (Retired)

Overview (Retired)

Use Oculus Plugin (Retired)

VST Options and Parameters (Retired)

3D Visualizer (Retired)

DAW-Specific Notes (Retired)

Legal Notifications (Retired)

Oculus AAX Spatializer for DAWs Integration (Retired)

Oculus AAX Spatializer for DAWs Integration Guide (Retired)

Overview (Retired)

Use 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)

Group Launch (Deprecated)

Peer-to-Peer Networking (Deprecated)

Rooms (Deprecated)

Rooms Client APIs (Deprecated)

Server APIs for Moderated Rooms (Deprecated)

Peer to Peer Voice Chat (VoIP) (Deprecated)

Tracked Keyboard (Deprecated)

Overview (Deprecated)

Get Started (Deprecated)

Integrate OVRTrackedKeyboard Prefab (Deprecated)

Debug Tracked Keyboard-Enabled Apps with Link (Deprecated)

Tracked Keyboard Sample (Deprecated)

Virtual Keyboard (Deprecated)

Overview (Deprecated)

Getting Started (Deprecated)

Sample Overview (Deprecated)

Integrating the OVRVirtualKeyboard Prefab (Deprecated)

Custom Integrations and Best Practices (Deprecated)

FAQ (Deprecated)

Archived Developer Tools

GPU Systrace (Deprecated)

Cloud Saves API (Deprecated)

Cloud Saves Deprecation

Meta XR Simulator

Download

Updated: Nov 21, 2024|

Version

Select your version

Meta XR Simulator is a lightweight OpenXR runtime built for developers and enables you to simulate Meta VR devices and features on the API level. This is the Unity integration and contains the OpenXR runtime, configuration files and supporting binaries for Windows64 and MacArm platforms.

Version 71 Release Notes

Documentation
Getting Started:
Unity
Unreal
Native

Feature Docs:
Meta XR Simulator Introduction
Passthrough Simulation
Scene Recorder
Scene Json Formatting
Session Capture (Record and Replay)
Multiplayer Testing
Hand Tracking
Body Tracking
Data Forwarding
Test Rooms
Automated Testing
What's New
MacOS support is fully integrated now into the UPM and doesn't require Homebrew anymore to work.
On Windows, the Synthetic Environment Server now starts in the background by default.
On MacOS, Synthetic Environment Servers can now be downloaded directly from within the Unity Editor.
Supported two OpenXR extensions: XR_EXT_hand_interaction and XR_EXT_eye_gaze_interaction.
Colocation discovery is now supported.
Environmental Depth is supported in DX12.
What's Fixed / Improved
The performance of Mixed Reality simulation on MacOS has been improved.
Known Issues
General issues
For the “connecting physical Quest controllers” feature, we recommend launching the server application from the headset before connecting.
MacOS specific issues
XR Simulator is compatible with OpenXR plugin 1.13+. If you are unable to see this plugin version, please upgrade your Unity editor to the latest patched version.
local_sharing_server will fail to start on Mac if a Synthetic Environment is run. This has no impact on single instance functionality and only blocks multi-instance anchor sharing.
If your project does NOT use Meta XR Core SDK, then the “Deactivate” menu item will not work properly. There is no impact as long as you are not using another OpenXR runtime on macOS.
Unreal Engine specific issues
Restarting XrSim sometimes causes Occlusion failures.

Build with Meta

Social Technologies

About us

Virtual reality / Meta Horizon

Meta Horizon Creator Program

Discover

Why Meta Quest?

What is mixed reality?

Platforms and tools

2D apps for Meta Horizon OS

Success stories

Support and legal

Developer policies

Build with Meta

Social Technologies

About us

Virtual reality / Meta Horizon

Meta Horizon Creator Program

Discover

Why Meta Quest?

What is mixed reality?

Platforms and tools

2D apps for Meta Horizon OS

Success stories

Support and legal

Developer policies

Build with Meta

Social Technologies

About us

Virtual reality / Meta Horizon

Meta Horizon Creator Program

Discover

Why Meta Quest?

What is mixed reality?

Platforms and tools

2D apps for Meta Horizon OS

Success stories

Support and legal

Developer policies

English (US)

© 2025 Meta