This repository provides a collection of code samples for the Meta Spatial SDK, enabling mobile developers to build immersive experiences for Meta Horizon OS using familiar Android tools and libraries. It serves as a valuable resource for developers looking to integrate spatial computing capabilities into their applications, offering practical examples of core SDK features.

How It Works

The Meta Spatial SDK bridges the gap between standard Android development and the unique capabilities of Meta Quest devices. The samples demonstrate how to leverage accessible APIs for features like spatial anchors, scene understanding, and object recognition. A key component is the Meta Spatial Editor, which integrates with the SDK via a custom Gradle plugin to facilitate scene composition and asset management within the development workflow.

Quick Start & Requirements

• Primary install/run command: Clone the repository, open a sample app in Android Studio, connect a Meta Quest device, and click "Run".
• Non-default prerequisites: Meta Quest device (Quest 2/3/3S/Pro) with v69.0+, Mac or Windows, Android Studio Hedgehog+, Meta Spatial Editor. NDK required for custom shaders in specific samples.
• Links: Official documentation: https://meta.com/ (Note: The README provides a general link, not a specific doc URL).

Highlighted Details

• Features 13 distinct sample applications showcasing diverse functionalities, including animations, hybrid 2D/3D experiences, custom components, media playback, mixed reality interactions, physics, body tracking, and UI elements.
• Includes 5 fully-featured Showcase applications (Focus, Media View, Geo Voyage, Spatial Scanner) demonstrating end-to-end use cases.
• Integrated support for AI coding agents, with configuration files and links to related agentic tools for enhanced development workflows.
• Utilizes a Spatial SDK Gradle Plugin for seamless integration with the Spatial Editor and build-time features like custom shader compilation.

Maintenance & Community

The repository is actively maintained by Meta. While specific community links (Discord/Slack) or a public roadmap are not detailed in the README, the project's integration with AI coding agent tools suggests a focus on modern development practices.

Licensing & Compatibility

The majority of the project is licensed under the permissive MIT License. However, the Meta Platform Technologies SDK license applies to the core SDK and supporting assets (e.g., 3D models, videos) found within sample asset folders. This dual-licensing structure requires careful review for commercial use, particularly concerning the proprietary MPT SDK licensed assets.

Limitations & Caveats

Most samples necessitate the installation and use of the Meta Spatial Editor. Certain samples also require manual setup of the Android NDK for custom shader functionalities. The Spatial SDK Gradle Plugin collects telemetry data to improve Meta products, which users should be aware of. The MPT SDK license may impose restrictions on the use of included assets.