Android Native

Overview

The MultiSet Android SDK provides Visual Positioning System (VPS) localization capabilities for Android applications. It enables precise indoor and outdoor localization using camera-based visual recognition against pre-mapped 3D environments.

GitHub Repository: https://github.com/MultiSet-AI/multiset-android-sdk.git

Table of Contents

Sample Activities

• MainActivity - Authentication and SDK initialization

• SingleFrameARActivity - Single-frame localization

• MultiFrameARActivity - Multi-frame localization

API Reference

• LocalizationConfig - Configuration parameters for localization behavior

Quick Start

1. Add Dependencies

Add the MultiSet SDK dependency to your app's build.gradle:

dependencies {
    implementation 'com.multiset.sdk:multiset-android-sdk:1.0.2'
}

2. Credentials Setup

Create a multiset.properties file in your project root with your credentials:

MULTISET_CLIENT_ID=your_client_id
MULTISET_CLIENT_SECRET=your_client_secret
MULTISET_MAP_CODE=your_map_code
MULTISET_MAP_SET_CODE=

Property	Description	Required
MULTISET_CLIENT_ID	Your client identifier	Yes
MULTISET_CLIENT_SECRET	Your secret key	Yes
MULTISET_MAP_CODE	Single map identifier	One of these is required
MULTISET_MAP_SET_CODE	Map set identifier	One of these is required

3. Initialize the SDK

val config = MultiSetConfig.Builder(clientId, clientSecret)
    .mapCode(mapCode)
    .enableMeshVisualization(true)
    .backgroundLocalization(true)
    .build()

MultiSetSDK.initialize(context, config, callback)

4. Implement Callbacks

class MainActivity : AppCompatActivity(), MultiSetCallback {
    override fun onSDKReady() { /* SDK initialized */ }
    override fun onAuthenticationSuccess() { /* Ready for localization */ }
    override fun onAuthenticationFailure(error: String) { /* Handle error */ }
    override fun onLocalizationSuccess(result: LocalizationResult) { /* Handle success */ }
    override fun onLocalizationFailure(error: String) { /* Handle failure */ }
    override fun onTrackingStateChanged(state: TrackingState) { /* Handle state change */ }
}

Requirements

• Android API Level 24+

• ARCore compatible device

• Camera permission

• Internet connectivity

License

Copyright (c) 2026 MultiSet AI. All rights reserved. Licensed under the MultiSet License. For license details, visit www.multiset.ai.