MultiSet Unity SDK

The MultiSet SDK provides powerful localization, navigation, and AR tracking capabilities for Unity applications. This package enables developers to integrate advanced spatial computing features with minimal setup.

📋 Prerequisites

Before getting started, ensure you have:

• Unity 6000.0.36f1 or later (minimum: Unity 2022.3.36+)

• Valid MultiSet credentials (Client ID and Client Secret)

• Map/MapSet/ModelSet codes from your MultiSet dashboard

• iOS/Android development tools for mobile deployment

• Basic Unity development experience

Project Setup :

Open Unity Hub and create a new 3D Project (Built-In Render Pipeline) or open your existing project

SDK Installation

Using Git URL (Recommended)

1. Navigate to Window → Package Manager

2. Click the "+" button in the top-left corner

3. Select "Add package from git URL"

4. Enter the following URL and click Add:

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

Verify Installation

After installation, you should see "MultiSet-SDK" listed in the Package Manager under "In Project".

Dependencies

The SDK automatically installs these required packages:

• Unity Cloud - Draco (5.1.7)

• Unity Cloud - glTFast (6.8.0)

• AR Foundation (6.0.3)

• AI Navigation (2.0.5)

Sample Scenes

The SDK includes comprehensive sample scenes to demonstrate key features.

Import Sample Scenes

1. Open Window → Package Manager

2. Find "MultiSet-SDK" in the package list

3. Click on the package to view details

4. Navigate to the "Samples" tab

5. Click "Import" next to "Sample Scenes"

The samples will be imported to:

Assets/Samples/MultiSet-SDK/[version]/Sample Scenes/

Available Sample Scenes

Configuration

Step 1: Configure API Credentials

1. Get your SDK credentials from : https://developer.multiset.ai/credentials

2. Navigate to the configuration file:

   Copy

   Assets/Samples/MultiSet-SDK/[version]/Sample Scenes/Resources/MultiSetConfig.asset

3. Open the ScriptableObject file in the Inspector

4. Enter ClientId and ClientSecret values:

   Copy

   Client Id = "YOUR_CLIENT_ID"
   Client Secret = "YOUR_CLIENT_SECRET"

Step 2: Configure Map Settings

1. Open your desired sample scene (e.g., Localization.unity)

2. Select the MultisetSdkManager GameObject in the Hierarchy

3. In the Inspector, locate the MapLocalizationManager component

4. Configure your localization method:

   • Map: For single, specific locations

   • MapSet: For multiple related locations or larger coverage areas

   • ModelSet: For 3D model tracking scenarios in ModelTrackingManager

5. Enter your corresponding code:

   • Map Code: For individual location mapping

   • MapSet Code: For grouped location sets

💡 Tip: You can obtain these codes from your MultiSet dashboard after creating maps.

Configure ModelSet Settings

1. Open ModelSetTracking sample scene

2. Select the MultisetSdkManager GameObject in the Hierarchy

3. In the Inspector, locate the ModelSetTrackingManager component

4. Enter your corresponding ModelSet code

Add Map Code and 3D Mesh (.glb) for AR content anchoring.

You can copy the Map Code from Maps section in the developer portal, import the scan in the Unity project, and add the scan under "Map Space". You can use the sample script Map Mesh Downloader provided in SDK to download Meshes directly in the SDK.

Select MultiSet SDK Manager and the Map Code of the map you want to perform localization.

Add your asset under "Map Space" GameObject.

Make sure to add all your assets as children of "Map Space" object, so post-successful localization your assets will appear at the right location with respect to the Map

Build for mobile devices

Once you are done adding all your assets in right place, then you can select File -> Build Profiles-> Choose iOS/Android -> Build

Try out localization

Once you run the app on a mobile device, the app will try to perform localization at the start of the scene and will set all the AR content relative to the Map of the area.

_{Updating SDK Package}

To update the SDK:

1. Open Package Manager

2. Find MultiSet-SDK

3. Click "Update" if available

4. Or remove and re-add with latest Git URL

For manual updates, use:

https://github.com/MultiSet-AI/multiset-unity-sdk.git#latest