Android Native

Overview

The MultiSet Android SDK provides Visual Positioning System (VPS) localization and Object Tracking capabilities for Android applications. It enables precise indoor and outdoor localization using camera-based visual recognition against pre-mapped 3D environments, and detects pre-registered physical objects in AR with animated 3D mesh visualization.

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

Table of Contents

Sample Activities

• MainActivity - Authentication, SDK initialization, and navigation

• MultiSetLocalizationActivity - Unified AR localization (single-frame & multi-frame)

• ObjectTrackingActivity - AR object detection and tracking with animated mesh overlay

API Reference

• LocalizationConfig - Configuration parameters for localization behavior

• ObjectTrackingConfig - Configuration parameters for object tracking behavior

Quick Start

1. Add Dependencies

Add the MultiSet SDK AAR to your app's libs/ directory and configure dependencies:

dependencies {
    implementation files('libs/multiset-sdk.aar')

    // ARCore
    implementation 'com.google.ar:core:1.46.0'
    implementation 'com.github.RGregat:sceneform-android:1.24.6'

    // Networking
    implementation 'com.squareup.retrofit2:retrofit:2.9.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.9.0'
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'

    // Coroutines
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.10.2'

    // Image Processing
    implementation 'com.google.mlkit:vision-common:17.3.0'
}

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=
MULTISET_OBJECT_CODES=OBJ_001,OBJ_002

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	MapSet identifier	One of these is required
MULTISET_OBJECT_CODES	Comma-separated object code list	Required for object tracking

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 and tracking */ }
    override fun onAuthenticationFailure(error: String) { /* Handle error */ }
    override fun onLocalizationSuccess(result: LocalizationResult) {
        // Access result.mapCode, result.mapCodes, result.position, result.rotation, result.confidence
    }
    override fun onLocalizationFailure(error: String) { /* Handle failure */ }
    override fun onTrackingStateChanged(state: TrackingState) { /* Handle state change */ }
    override fun onObjectTrackingSuccess(result: ObjectTrackingResult) {
        // Access result.objectCode, result.objectCodes, result.position, result.rotation, result.confidence
    }
    override fun onObjectTrackingFailure(error: String) { /* Handle tracking failure */ }
}

5. Retrieve Localization Result

The localization result is delivered via onLocalizationSuccess callback and can also be retrieved at any time:

val lastResult = MultiSetSDK.getLastLocalizationResult()

Requirements

• Android API Level 28+ (Android 9.0)

• Target SDK 36

• Java 17

• Kotlin 2.2.0+

• 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.