Meta Developers

Why Meta Quest?

Login

Develop

Develop

Select your platform

Setting up your dev environment

Installing Unreal Engine

Installing Android Studio

Installing the Meta XR Plugin

Configuring your headset

Choosing UE 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

Interaction Lifecycle

Grabbing Objects

Grab Interactions

Hand Grab Poses

Custom Distance Grab Visuals

Custom Ray Grab Visuals

Playing Sounds for Interactions

Troubleshooting

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

Custom User Input Mapping

Enable controllers

Getting Started

Creating a Distance Grab Interaction

Controller Input Mapping

Oculus Touch Controller

Touch Plus Controllers

Controllers Best Practices

Controllers Troubleshooting

Enable Hand Tracking

Set Up Hand Tracking

Add Spatial Audio

Using the Unreal Spatializer Plugin

Getting Started

Troubleshooting

Using the FMOD Spatializer Plugin

Getting Started

Troubleshooting

Using the Wwise Spatializer Plugin

Getting Started

Unreal Integration

Parameter Reference

Troubleshooting

Using Acoustic Ray Tracing

Getting Started

Project Settings

Troubleshooting

Integrate Mixed Reality

Use Mixed Reality Utility Kit

Passthrough Relighting Sample

Add Real-World View with Passthrough

Getting Started

Passthrough Over Link

Persistent Passthrough

Passthrough Styling

Color Mapping Techniques

Creating Passthrough Color LUTs

Neutral Color LUTs

Compositing and Masking

Passthrough Windows

Surface Projected Passthrough

Passthrough Loading Screens

Troubleshooting

Passthrough Window Tutorial

Color LUT Tutorial

Projected Passthrough Tutorial

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)

Managed Accounts

Managed Account API Overview

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

Save Game Best Practices

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

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

Meta Fork Game Engine Performance Enhancement

Basic Optimization Workflow for Meta Horizon OS Apps

Dynamic Resolution

Using RenderDoc Meta Fork to Optimize Your App - Part 1

Using RenderDoc Meta Fork to Optimize Your App - Part 2

Application SpaceWarp Developer Guide

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

Manage Your Headset

Set Up Headset with MQDH

Debugging Tools

Create Custom Command

Performance Analyzer

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

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

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

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

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

Oculus Spatializer Features

Oculus Spatializer for Unreal Engine

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

Viseme Reference

Use Oculus Lipsync with Unreal

Precompute Visemes to Save CPU with Unreal

Explore Oculus Lipsync with the Sample Scene for Unreal

Oculus Audio Profiler

Setup the Profiler

Profile Spatialized Audio

Oculus Audio Loudness Meter

Setup the Loudness Meter

Measure Loudness

Archived Developer Tools

GPU Systrace (Deprecated)

Cloud Saves API (Deprecated)

Cloud Saves Deprecation

Supported platforms

Developer Tools

Back to Unreal Engine

Exporting rooms from headset for testing Meta XR Simulator

Updated: Sep 25, 2024

Overview

Scene Data Recorder enables the user to record their own scene data from the Room Capture setup on their headset. Once recorded, the user can update the default scene in the Meta XR Simulator and use their room in the simulation to aid development.

Requirements

You will need to have a space setup already available in your headset. Once you download the latest OS, go to Settings > Physical Space > Space Setup > Set Up and follow the instructions to set up your space.

Set up the scene data recorder

Install and setup the Meta XR Simulator with your development environment. For more info, see Getting Started with Meta XR Simulator.
Install the SceneDataRecorder APK in the Meta XR Simulator package by going to \\MetaXRSimulator\data_recorders.
Install the same APK in your headset.
Grant storage permissions to record Scene data in your headset. Go to Settings > Apps and find the SceneDataRecorder Sample. Set Storage and Spatial data to enabled.

Record your room capture

Run the application to initate and complete space setup. Once you select Finish, the room will be recorded into a JSON file, scene_anchors_empty_room.json in the headset.
Move this file from the headset to the Meta XR Simulator project folder. To do this, run the following command in powershell.

adb pull /sdcard/scene_anchors_empty_room.json
Meta XR Simulator package folder\config\anchors

To use Scene JSON in the Meta XR Simulator go to Mixed Reality.
Click the … button and select the new scene JSON file.
Click the Load button.
Click the Exit Simulator button. The scene will now stop and the simulator window will correctly disappear.
Play the game again. When the simulator window appears, you will see your new scene now appearing in the simulator.

When SES is running, you will see both the SES environment, and the data from the scene JSON file at the same time. To see only the data from your scene JSON, do the following:

Exit the simulator.
Stop the SES server, then press play.

You will now see the scene JSON data independently of the SES environment.

Stop scene JSON

To stop scene JSON, you will need to go to %user%\AppData\Roaming\MetaXR\MetaXrSimulator\persistent_data.json to remove scene_anchor_data from the JSON.

Understand the JSON room file

If you wish to update a JSON room, understanding the JSON schema is necessary. Please refer to Meta XR Simulator Room JSON Syntax for more details.

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)

© 2025 Meta