Develop

Develop

Select your platform

Setting up your development environment

Installing Unreal Engine

Installing Android Studio

Installing the Meta XR Plugin

Configuring your headset

Choosing Unreal Enigne installation by feature compatibility

PC-VR Integration for Unreal Engine

Setting up your first project

Configuring the Meta XR plugin

Choosing an OpenXR Backend

Packaging your new project

Meta XR plugin settings

Unreal Engine Royalty Payment Program

Add user input and interactions

Getting Started

Custom Hand and Controller Meshes

Interaction Lifecycle

Grabbing Objects

Grab Interactions

Hand Grab Poses

Custom Distance Grab Visuals

Custom Ray Grab Visuals

Playing Sounds for Interactions

Troubleshooting

Getting Started

Creating a Distance Grab Interaction

Controller Input Mapping

Oculus Touch Controller

Touch Plus Controllers

Controllers Best Practices

Controllers Troubleshooting

Set Up Hand Tracking

Feature Walkthrough

Troubleshooting

Troubleshooting

Other Runtime APIs

Add Realism using Movement SDK

Getting Started

Code Walkthrough

Movement Sample

Advanced Material

Troubleshooting

Morph Target Visual Reference

Body Joints Visual Reference

Integrate Voice Features

Integrating Voice SDK

Enabling Voice Commands

Setup Voice Command

Redirecting the Wit Endpoint

Versioning Your App

Providing Voice Transcriptions

Providing Visual Feedback

Live Understanding

Enabling Dictation

Using Text-to-Speech (TTS)

TTS Voice Customization

TTS Cache Options

Troubleshooting

Add Spatial Audio

Integrate Mixed Reality

Use Mixed Reality Utility Kit

Passthrough Relighting Sample

Add Real-World View with Passthrough

Create Depth Perception

Troubleshooting and FAQ

Spatial Data Permissions

Semantic Labels for Scenes

Migrate to MR Utility Kit

Get Started with Scene Actor

Importing Scene Entity Meshes

Blueprint Reference

Using Spatial Anchors

Getting Started

Spatial Anchors

Shared Spatial Anchors

Colocation Discovery

Troubleshooting

Blueprint Reference

Mixed Reality Experience and Use Cases

Platform Solutions

Getting Started Guide

Server-to-Server API Basics

Set Up for Platform Development

Multiplayer Features

Multiplayer Overview

Multiplayer Enablement

Testing and Use Cases

App to App Travel

Invokable Error Dialogs

SharedSpaces Multiplayer Showcase

Multiplayer Testing

Multiplayer Testing with Link

Multiplayer Testing with 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 Apps

Monetization Overview

Add-ons - Downloadable Content and In-App Purchases

Add-ons Integration

Add-on 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)

User Management

User Management Overview

Entitlement Check

Account Linking

Security Overview

Attestation API

Get Age Category API

Lying Down Mode

Quest Tools Overview

Asset Files to Manage Download Size

App Deep Linking

System Deep Linking

Requiring Minimum OS Versions

Save Game Best Practices

Shader Compilation

Platform Services

Cross-Device Development with App Groupings

Platform Reference

Platform Release Notes Archive

Display and Rendering Capabilities

Fixed Foveated Rendering

Eye Tracked Foveated Rendering

Set Display Refresh Rates

Enabling Phase Sync Adaptive Frame Timing

Enabling Late Latching

Unreal Forward Shading Renderer

Adaptive Pixel Density

VR Compositor Layers

Layer Filters - SuperSampling and Sharpening with MQSR

Color Space and Color Scaling

Material shader statistics with Adreno Offline Compiler

Performance and Optimization

Building and Packaging Apps

Iteration Speed Best Practices

Reduce App Deploy Time During Development

Improve Compile Times with FASTBuild

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

Testing and Performance Analysis

PC-VR - Testing and Performance Analysis

Enhance the User Interface

Overlays and Input Focus

Enable Keyboard Overlays for Text Input

Mixed Reality Capture

Creating without a Boundary

Social Applications and Revenue

Publish Your App

Unreal Engine Royalty Payment Program

Set Target Device and Get Device Type at Runtime

Upload App to Meta Horizon Store

Meta XR Plugin Settings

Developer Tools

Using Link for App Development

Meta XR Project Setup Tool

Meta XR Mixed Reality Template

Meta Quest Developer Hub (MQDH)

Get started with MQDH

Set up headset with MQDH

Manage your headset with MQDH

Enable AI tools with MCP for Meta Horizon OS developers

MQDH debugging tools

Create a custom command

Performance analyzer and metrics

How to take Perfetto traces

Layer visibility control

Explore MQDH file manager

Add, remove, and switch between multi-user accounts

Deploy APK builds to headset devices

Troubleshooting MQDH

Submit and track bugs and feature requests

Collect VrApi Logs with Logcat

Logcat Stats Definitions

Configure Android System Properties

Use ADB with a Headset

Performance Tools

Unreal Insights

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

Meta XR Simulator

Getting Started

Interaction Simulation

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

Simulate User Input from Meta Quest Controllers

Point-and-Click

Simulate a Mixed Reality Environment

Build your room in the Synthetic Environment Builder

Record and Replay

Multiplayer Testing

Samples and Showcases

Unreal Showcases

Train Hand Tracking Sample

Shared Spatial Anchor

Blueprints Reference

Color Management

Get Hmd Color Desc

Set Client Color Desc

Set Color Scale and Offset

Get Guardian Dimensions

Get Guardian Points

Get Node Guardian Intersection

Get Play Area Transform

Get Point Guardian Intersection

Is Guardian Displayed

Set Guardian Visibility

Get Hand Skeletal Mesh

Get Dominant Hand

Get Bone Rotation

Get Pointer Pose

Initialize Hand Physics

Is Pointer Pose Valid

Is Hand Tracking Enabled

Get Controller Type

Get Oculus MR Settings

Get Tracking Reference Component

Set Tracking Reference Component

Overlay and Dash Blueprints

Has Input Focus

Add Passthrough Layer Component

Add Static Surface Geometry

Remove Static Surface Geometry

Add Procedural Surface Geometry

Remove Procedural Surface Geometry

Enable Color Map

Enable Edge Color

Set Color Map Curve

Set Color Map Type

Set Edge Rendering Color

Set Texture Opacity

Performance Optimization Blueprints

Get Available Display Frequencies

Get Current Display Frequency

Set Display Frequency

Get GPU Frame Time

Get GPU Utilization

Set CPU and GPU Levels

Position and Orientation

Enable Orientation Tracking

Enable Position Tracking

Get Base Rotation and Base Offset in Meters

Get Raw Sensor Data

Is Device Tracked

Set Base Rotation and Base Offset in Meters

Add Loading Splash Screen

Clear Loading Splash Screen

Enable Auto-Loading Splash Screen

User, Device, and Account

Get Device Type

Get User Profile

Verify User Entitlement

Console Command Reference

Experimental Features

UE4 Installation

Retired Blueprints

Has System Overlay Present (Retired)

Oculus Avatars (Retired)

Overview (Retired)

Avatars Upgrade Guide (Retired)

Avatar Developer Guide (Retired)

Expressive Features for Avatars (Retired)

Avatar SDK Developer Reference (Retired)

Avatars After 4.26 Unreal Engine (Retired)

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 Unreal Apps

Archived Developer Tools

Compositing and Mapping

By default, a passthrough layer uses automatic environment reconstruction, which covers the entire screen. There are multiple ways to combine passthrough and VR in interesting ways to create mixed reality experiences:

Passthrough AR - Passthrough shows up wherever your virtual scene doesn’t cover the screen.

Occlusion - Occlude virtual objects by real objects, and let passthrough show only in selected regions.

Passthrough Windows - Create windows through which passthrough is visible.

These techniques are not mutually exclusive. They can be combined to create more sophisticated visualizations.

Did you find this page helpful?

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)

© 2026 Meta