Meta Developers

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 66 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
Body Tracking
Data Forwarding
Test Rooms
Automated Testing
MacOS Support (Experimental)
What's New
Added support for Apple Silicon Macs. Developers can install through Homebrew. Please check the full instructions here.
Added 8 new Synthetic Environments in ses_rooms~/
Added JsonServer to serve scanned rooms from config/Anchors/ or generated from SceneRecorder.
“Did you know?” dialog will be displayed at startup
Release Notes displays a hyperlink to documentation
[Unity] Added a new button next to the Unity Play Button to quickly activate/deactivate Meta XR Simulator (Requires Meta XR SDK Core)
[Unity] Added a new tab for Meta XR Simulator in Unity user preferences (Requires Meta XR SDK Core)
[Unity] New submenu item Synthetic Environment Server>More Rooms to access the new Environments
[Unity] New submenu item Synthetic Environment Server>JSON Server to select the scanned room to use
What's Fixed / Improved
Vulkan RHI backend enabled by default
Record and Replay works on MacOS
Active devices are directly selectable via checkboxes
Fonts on High Resolution DPI screens should render correctly
Exception Handling prevents XrSim failures from crashing the engine
Known Issues
General issues
There is an issue with hand gesture simulation, which will be fixed in the next upcoming version.
Scene Model will output correct objects with semantic labels on DX11 only. DX12 and vulkan are not fully compatible yet.
MRUK Virtual Home has orientation issues at the moment using XR SIM.
Capture & Replay might not recreate anchors or menus in some scenarios.
Camera Spins when the user moves the cursor out of the xr sim interface. Keep the cursor in the frame of XR SIM or use a full window.
To enable occlusions, the user will need to add “disable_interop”: true to the persistent_data.json file.
Close the SES after quitting the project and re-open a new SES to use for a new project otherwise the user will see a windows error message from the local sharing server.
Vulkan specific issues
Vulkan support is limited. Depth composition is not supported in the reference compositor
Unreal Engine specific issues
RSim Occlusions only supported in Meta Unreal Engine fork.
When using VR Preview to launch a project for the first time, the XR Sim Window may not appear immediately. To display the window correctly, simply stop and restart the project.
Meta XR Simulator may lose controller input if users switch back to the Unreal Editor window. The workaround is to focus on the PIE (play-in-editor) window and then alt-tab to switch to Simulator.
To close Meta XR Simulator, users need to use “stop VR-Preview” from Unreal Engine’s editor.
On Partner Engine using Meta XR Simulator, use Quest 3 as your main device to refrain from SES on-going issues.
Mac specific issues
The performance of passthrough simulation using Synthetic Environment Server is not optimal and will be optimized in the future.