This repository is a collection of code samples that demonstrate the capabilities of Meta Spatial SDK. Meta Spatial SDK is a new way to build immersive apps for Meta Horizon OS. Meta Spatial SDK lets you combine the rich ecosystem of Android development and the unique capabilities of Meta Quest via accessible APIs.
The samples in this repository are used for New Project Templates by the Meta Horizon Plugin for Android Studio. Each sample project includes source code, build scripts, and documentation to help developers understand how to use the SDK to build their own spatially-aware applications.
To try out these sample apps, you will need:
- A Meta Quest device (Quest 2/3/3S/Pro)
- Mac or Windows
- Android Studio Hedgehog or newer
- Meta Spatial Editor
First, ensure that all of the requirements are met.
Then, to build and run a sample:
- Add the Meta Horizon Plugin for Android Studio to your Android Studio IDE.
- In the main toolbar, press "File" -> "New Spatial SDK Project" -> Fill out your project's information -> "Create"
- Plug in your Quest device to your computer
- Click the "Run" button in the Android Studio toolbar, the app will now be running on your headset
Notes:
- The templates require you to install Meta Spatial Editor.
We currently have 1 template app:
- StarterTemplate is a starter project that shows a basic 3D immersive scene with panels that communicate with each other.
The documentation for Meta Spatial SDK can be found here.
Find our official release notes here.
The samples all include the Spatial SDK Gradle Plugin in their build files. This plugin is used for the Spatial Editor integration and for build-related features like custom shaders.
Meta collects telemetry data from the Spatial SDK Gradle Plugin to help improve MPT Products. You can read the Supplemental Meta Platforms Technologies Privacy Policy to learn more.
The Meta Spatial SDK Templates package is multi-licensed.
The majority of the project is licensed under the Zero-Clause BSD License, as found in the LICENSE file.
The Meta Platform Technologies SDK license applies to the Meta Spatial SDK and supporting material, and to the assets used in the Meta Spatial SDK Templates package. The MPT SDK license can be found in the asset folder of each sample.
Specifically, all the supporting materials in each template's app/src/main/assets folders including 3D models, videos, sounds, and others, are licensed under the MPT SDK license.