MeasurementManager Directory Reference

Directories
	dart
	java
	kotlin
	objc
	swift

Detailed Description

This directory contains comprehensive examples demonstrating the usage of the Navigine SDK's MeasurementManager across all supported platforms.

Overview

The MeasurementManager is responsible for managing measurement generators and notifying about sensor and signal measurements. It provides functionality for:

• Sensor Measurements: Accelerometer, magnetometer, gyroscope, barometer, location, and orientation data
• Signal Measurements: Wi-Fi, Bluetooth, iBeacon, Eddystone, and Wi-Fi RTT signals
• Measurement Generators: Simulating various types of signals for testing and development
• Real-time Monitoring: Receiving live measurement data through listeners

Key Components

MeasurementManager

The main class for managing measurement operations:

• addMeasurementListener() / removeMeasurementListener() - Manage measurement listeners
• addBeaconGenerator() / removeBleGenerator() - Manage BLE beacon generators
• addEddystoneGenerator() - Manage Eddystone beacon generators
• addWifiGenerator() / removeWifiGenerator() - Manage Wi-Fi generators
• addWifiRttGenerator() / removeWifiRttGenerator() - Manage Wi-Fi RTT generators
• addLocationGenerator() / removeLocationGenerator() - Manage location generators

MeasurementListener

Interface for receiving measurement notifications:

• onSensorMeasurementDetected() - Called when new sensor measurements are available
• onSignalMeasurementDetected() - Called when new signal measurements are available

SensorMeasurement

Represents sensor measurement data:

• type - Type of sensor (ACCELEROMETER, MAGNETOMETER, GYROSCOPE, BAROMETER, LOCATION, ORIENTATION)
• values - 3D vector containing measurement values
• time - Timestamp of the measurement

SignalMeasurement

Represents signal measurement data:

• type - Type of signal (WIFI, BEACON, BLUETOOTH, EDDYSTONE, WIFI_RTT)
• id - Unique identifier of the signal
• rssi - Received Signal Strength Indicator
• distance - Estimated distance to the signal source
• time - Timestamp of the measurement

Vector3d

3D vector structure for sensor measurements:

• x, y, z - Coordinates of the 3D vector

Platform-Specific Files

Dart/Flutter

• dart/measurement_manager_example.dart - Complete example with all MeasurementManager features

Java

• java/MeasurementManagerExample.java - Java implementation with comprehensive API coverage

Kotlin

• kotlin/MeasurementManagerExample.kt - Kotlin implementation using coroutines for async operations

Objective-C

• objc/MeasurementManagerExample.h - Header file with interface declarations
• objc/MeasurementManagerExample.m - Implementation with all MeasurementManager methods

Swift

• swift/MeasurementManagerExample.swift - Swift implementation with modern syntax

Key Documentation Tags

MeasurementManager Methods

• [platform_MeasurementManager_addMeasurementListener] - Adding measurement listeners
• [platform_MeasurementManager_removeMeasurementListener] - Removing measurement listeners
• [platform_MeasurementManager_addBeaconGenerator] - Adding BLE beacon generators
• [platform_MeasurementManager_addEddystoneGenerator] - Adding Eddystone generators
• [platform_MeasurementManager_addWifiGenerator] - Adding Wi-Fi generators
• [platform_MeasurementManager_addWifiRttGenerator] - Adding Wi-Fi RTT generators
• [platform_MeasurementManager_addLocationGenerator] - Adding location generators
• [platform_MeasurementManager_removeBleGenerator] - Removing BLE generators
• [platform_MeasurementManager_removeWifiGenerator] - Removing Wi-Fi generators
• [platform_MeasurementManager_removeWifiRttGenerator] - Removing Wi-Fi RTT generators
• [platform_MeasurementManager_removeLocationGenerator] - Removing location generators
• [platform_MeasurementManager_removeBleGenerators] - Removing all BLE generators
• [platform_MeasurementManager_removeWifiGenerators] - Removing all Wi-Fi generators
• [platform_MeasurementManager_removeWifiRttGenerators] - Removing all Wi-Fi RTT generators
• [platform_MeasurementManager_removeLocationGenerators] - Removing all location generators

MeasurementListener Methods

• [platform_MeasurementListener_onSensorMeasurementDetected] - Sensor measurement callbacks
• [platform_MeasurementListener_onSignalMeasurementDetected] - Signal measurement callbacks

SensorMeasurement Properties

• [platform_SensorMeasurement_getType] - Getting sensor type
• [platform_SensorMeasurement_getValues] - Getting sensor values
• [platform_SensorMeasurement_getTime] - Getting measurement timestamp

SignalMeasurement Properties

• [platform_SignalMeasurement_getType] - Getting signal type
• [platform_SignalMeasurement_getId] - Getting signal identifier
• [platform_SignalMeasurement_getRssi] - Getting RSSI value
• [platform_SignalMeasurement_getDistance] - Getting estimated distance
• [platform_SignalMeasurement_getTime] - Getting measurement timestamp

Vector3d Properties

• [platform_Vector3d_getX] - Getting X coordinate
• [platform_Vector3d_getY] - Getting Y coordinate
• [platform_Vector3d_getZ] - Getting Z coordinate

Common Usage Patterns

1. Initialization

// Get SDK instance and managers
NavigineSdk sdk = NavigineSdk.getInstance();
LocationManager locationManager = sdk.getLocationManager();
MeasurementManager measurementManager = sdk.getMeasurementManager(locationManager);

2. Setting up Measurement Listener

MeasurementListener listener = MeasurementListener(
  onSensorMeasurementDetected: (sensors) {
    // Handle sensor measurements
  },
  onSignalMeasurementDetected: (signals) {
    // Handle signal measurements
  },
);
 
measurementManager.addMeasurementListener(listener);

3. Adding Signal Generators

// Add BLE beacon generator
String beaconId = measurementManager.addBeaconGenerator(
  "12345678-1234-1234-1234-123456789012", // UUID
  100, // major
  200, // minor
  -60, // power (dBm)
  5000, // timeout (ms)
  -80, // rssiMin
  -40  // rssiMax
);
 
// Add Wi-Fi generator
String wifiId = measurementManager.addWifiGenerator(
  "AA:BB:CC:DD:EE:FF", // MAC address
  4000, // timeout (ms)
  -90, // rssiMin
  -50  // rssiMax
);

4. Processing Measurements

void onSensorMeasurementDetected(Map<SensorType, SensorMeasurement> sensors) {
  sensors.forEach((sensorType, measurement) {
    Vector3d values = measurement.values;
    print("Sensor ${sensorType}: X=${values.x}, Y=${values.y}, Z=${values.z}");
  });
}
 
void onSignalMeasurementDetected(Map<String, SignalMeasurement> signals) {
  signals.forEach((signalId, measurement) {
    print("Signal ${measurement.id}: RSSI=${measurement.rssi}dBm, Distance=${measurement.distance}m");
  });
}

5. Cleanup

// Remove specific generators
measurementManager.removeBleGenerator(beaconId);
measurementManager.removeWifiGenerator(wifiId);
 
// Remove all generators
measurementManager.removeBleGenerators();
measurementManager.removeWifiGenerators();
 
// Remove listener
measurementManager.removeMeasurementListener(listener);

Running Examples

Dart/Flutter

cd examples/MeasurementManager/dart
dart measurement_manager_example.dart

Java

cd examples/MeasurementManager/java
javac MeasurementManagerExample.java
java MeasurementManagerExample

Kotlin

cd examples/MeasurementManager/kotlin
kotlinc MeasurementManagerExample.kt -include-runtime -d MeasurementManagerExample.jar
java -jar MeasurementManagerExample.jar

Objective-C

cd examples/MeasurementManager/objc
clang -framework Foundation MeasurementManagerExample.m -o MeasurementManagerExample
./MeasurementManagerExample

Swift

cd examples/MeasurementManager/swift
swift MeasurementManagerExample.swift

Notes

• All examples demonstrate the same functionality across platforms
• Measurement generators are used for simulating signals during development
• Real sensor and signal measurements require appropriate hardware and permissions
• Listeners should be properly removed to prevent memory leaks
• Timeout values for generators are in milliseconds
• RSSI values are typically in the range of -100 to 0 dBm
• Distance values are in meters
• Timestamps are in milliseconds since epoch