Installation Guide

The MultiSet Quest SDK is a Unity-based development kit designed specifically for Meta Quest headsets. It provides developers with seamless integration to MultiSet's Visual Positioning System (VPS), enabling precise real-time localization, pose visualization, and camera access within virtual and mixed reality applications.

What You Can Build

With the MultiSet SDK, you can create applications that:

• Track user position and orientation in real-world environments

• Anchor virtual objects to physical locations

• Build location-aware AR/VR experiences

• Implement spatial mapping and navigation systems

Key Capabilities

• Real-time Localization: Leverage MultiSet's VPS API for centimeter-accurate positioning

• Pose Visualization: Built-in 3D gizmos and world axes for debugging and development

• Camera Integration: Direct access to Meta Quest passthrough cameras

• Quest Optimization: Lightweight implementation optimized for Quest hardware

• Plug-and-Play: Minimal setup required for immediate integration

Getting Started

MultiSet Quest SDK - Installation Guide

📋 Prerequisites

Before you begin, make sure you have the following:

🚀 Quick Start Installation

Method 1: Git URL (Recommended)

1. Create or open your Unity project

   • New project: Select Universal 3D or 3D (Built-In Render Pipeline)

   • Existing project: Ensure compatibility with Unity 6.0+

2. Add the SDK package

   Copy

   Window → Package Manager → + → Add package from git URL

3. Enter the repository URL

   Copy

   https://github.com/MultiSet-AI/multiset-quest-sdk.git

4. Verify installation

   • Check that "MultiSet Quest SDK" appears under "In Project" in Package Manager

📦 Automatic Dependencies

The SDK automatically installs these essential packages:

• Unity Cloud - Draco (5.1.7)

• Unity Cloud - glTFast (6.8.0)

• Meta XR Core SDK (77.0.0)

• Meta MR Utility Kit (77.0.0)

• XR Plugin Management (4.5.1)

• OpenXR Plugin (1.15.1)

🎯 Import Sample Scenes

Get started quickly with our comprehensive examples:

1. Open Package Manager → Find "MultiSet Quest SDK"

2. Navigate to Samples tab → Click "Import" next to "Sample Scenes"

3. Samples location: Assets/Samples/MultiSet Quest SDK/[version]/Single Frame Localization/Scenes/

The sample scenes demonstrate core SDK functionality and serve as implementation references.

⚙️ Configuration Setup

Step 1: API Credentials Configuration

Navigate to the configuration file:

Assets/Samples/MultiSet Quest SDK/[version]/Single Frame Localization/Resources/MultiSetConfig.asset

Update your credentials:

Client Id = "YOUR_CLIENT_ID_HERE"
Client Secret = "YOUR_CLIENT_SECRET_HERE"

💡 Get your credentials: Visit Developer Portal to obtain your Client ID and Secret

Step 2: XR Plugin Management Setup

1. Project Settings: Edit → Project Settings → XR Plug-in Management

2. Install if needed: Click "Install XR Plugin Management"

3. Enable OpenXR: Check the OpenXR checkbox under Plug-in Provider.

Step 3: Android Platform Configuration

1. Switch Platform: File → Build Settings → Android → Switch Platform

2. Validate Setup: Edit → Project Settings → XR Plug-in Management → Project Validation

3. Fix Issues: Click "Fix All" to resolve any configuration problems

Under Project Settings -> Meta XR -> Project Setup Tool -> Click on Fix All to add

This will add a Plugin folder with an Android Manifest file in the Assets directory

Step 4: Map Configuration

Configure your localization settings in the sample scene:

1. Open sample scene: SingleFrameLocalization.unity

2. Select MultisetSdkManager GameObject in Hierarchy

3. Configure localization method in SingleFrameLocalizationManager component:

📍 Obtain codes: Get your Map/MapSet codes from the MultiSet Developer Dashboard

Step 5: Download Map Mesh in Unity Editor

Follow the Map Mesh Downloader page to add the Mesh in Unity Editor for content authoring

Step 6: Camera Permissions

When you build the project, the Meta SDK will show you a pop-up for adding camera permission

The SDK automatically configures required permissions. Verify in Assets/Plugins/Android/AndroidManifest.xml:

<uses-permission android:name="horizonos.permission.HEADSET_CAMERA" />

\🏗️ Build and Deploy

Build Configuration

1. Build Settings: File → Build Settings

2. Select Platform: Android

3. Add Scenes: Click "Add Open Scenes"

Essential Android Settings:

• Scripting Backend: IL2CPP

• Target Architectures: ARM64

• Minimum API Level: 32+

Testing Deployment

1. Build and Run: Connect your Quest device and click "Build and Run"

2. Grant Permissions: Allow camera access when prompted

3. Test Localization: Verify functionality in your target environment

4. Validate AR Features: Ensure all AR capabilities work as expected

🛠️ API Reference

Core SDK Components

Common Issues and Solutions