navigine_sdk_example.dart

Go to the documentation of this file.

import 'package:navigine_sdk/navigine_sdk.dart';

class NavigineSdkExample {
  NavigineSdk? _sdk;
  LocationManager? _locationManager;
  NavigationManager? _navigationManager;
  ZoneManager? _zoneManager;
  RouteManager? _routeManager;
  AsyncRouteManager? _asyncRouteManager;
  NotificationManager? _notificationManager;
  MeasurementManager? _measurementManager;
  LocationListManager? _locationListManager;
  StorageManager? _storageManager;
  MqttSession? _mqttSession;
  LocationWindow? _locationWindow;
  RouteLayer? _routeLayer;
  GuidanceCamera? _guidanceCamera;
 
  NavigineSdkExample() {
    _initializeSdk();
  }

  void _initializeSdk() {
    try {
      // [dart_NavigineSdk_getInstance]
      // Get SDK instance
      _sdk = NavigineSdk.getInstance();
      // [dart_NavigineSdk_getInstance]
 
      // [dart_NavigineSdk_getVersion]
      // Get SDK version
      print('Navigine SDK Version: ${NavigineSdk.getVersion()}');
      // [dart_NavigineSdk_getVersion]
 
      // [dart_NavigineSdk_getDeviceId]
      // Get device ID
      print('Device ID: ${NavigineSdk.getDeviceId()}');
      // [dart_NavigineSdk_getDeviceId]
 
      // [dart_NavigineSdk_getRelativeTime]
      // Get relative time
      print('Relative Time: ${NavigineSdk.getRelativeTime()}');
      // [dart_NavigineSdk_getRelativeTime]
 
      // [dart_NavigineSdk_setUserHash]
      // Set user hash (authorization token)
      _sdk?.setUserHash('XXXX-XXXX-XXXX-XXXX');
      // [dart_NavigineSdk_setUserHash]
 
 
      // [dart_NavigineSdk_getUserAgent]
      print("User-Agent: ${NavigineSdk.getUserAgent()}");
      // [dart_NavigineSdk_getUserAgent]
 
      // [dart_NavigineSdk_reset]
      _sdk!.reset();
      print("SDK reset to initial state");
      // [dart_NavigineSdk_reset]
 
      // [dart_NavigineSdk_setServer]
      // Set server URL (optional)
      _sdk?.setServer('https://custom.navigine.com');
      // [dart_NavigineSdk_setServer]
 
      // Initialize managers
      _initializeManagers();
    } catch (e) {
      print('SDK initialization error: $e');
    }
  }

  void _initializeManagers() {
    // [dart_NavigineSdk_getLocationManager]
    // Get LocationManager for working with locations
    _locationManager = _sdk?.getLocationManager();
    if (_locationManager != null) {
      print('LocationManager successfully initialized');
    }
    // [dart_NavigineSdk_getLocationManager]
 
    // [dart_NavigineSdk_getNavigationManager]
    // Get NavigationManager for navigation
    if (_locationManager != null) {
      _navigationManager = _sdk?.getNavigationManager(_locationManager!);
      if (_navigationManager != null) {
        print('NavigationManager successfully initialized');
      }
    }
    // [dart_NavigineSdk_getNavigationManager]
 
    // [dart_NavigineSdk_getZoneManager]
    // Get ZoneManager for working with zones
    if (_navigationManager != null) {
      _zoneManager = _sdk?.getZoneManager(_navigationManager!);
      if (_zoneManager != null) {
        print('ZoneManager successfully initialized');
      }
    }
    // [dart_NavigineSdk_getZoneManager]
 
    // [dart_NavigineSdk_getRouteManager]
    // Get RouteManager for building routes
    if (_locationManager != null && _navigationManager != null) {
      _routeManager = _sdk?.getRouteManager(
        _locationManager!,
        _navigationManager!,
      );
      if (_routeManager != null) {
        print('RouteManager successfully initialized');
      }
    }
    // [dart_NavigineSdk_getRouteManager]
 
    // [dart_NavigineSdk_getAsyncRouteManager]
    // Get AsyncRouteManager for async route operations
    if (_locationManager != null && _navigationManager != null) {
      _asyncRouteManager = _sdk?.getAsyncRouteManager(
        _locationManager!,
        _navigationManager!,
      );
      if (_asyncRouteManager != null) {
        print('AsyncRouteManager successfully initialized');
      }
    }
    // [dart_NavigineSdk_getAsyncRouteManager]
 
    // [dart_NavigineSdk_getNotificationManager]
    // Get NotificationManager for notifications
    if (_locationManager != null) {
      _notificationManager = _sdk?.getNotificationManager(_locationManager!);
      if (_notificationManager != null) {
        print('NotificationManager successfully initialized');
      }
    }
    // [dart_NavigineSdk_getNotificationManager]
 
    // [dart_NavigineSdk_getMeasurementManager]
    // Get MeasurementManager for measurements
    if (_locationManager != null) {
      _measurementManager = _sdk?.getMeasurementManager(_locationManager!);
      if (_measurementManager != null) {
        print('MeasurementManager successfully initialized');
      }
    }
    // [dart_NavigineSdk_getMeasurementManager]
 
    // [dart_NavigineSdk_getLocationListManager]
    // Get LocationListManager for location list operations
    _locationListManager = _sdk?.getLocationListManager();
    if (_locationListManager != null) {
      print('LocationListManager successfully initialized');
    }
    // [dart_NavigineSdk_getLocationListManager]
 
    // [dart_NavigineSdk_getStorageManager]
    // Get StorageManager for working with storages
    _storageManager = _sdk?.getStorageManager();
    if (_storageManager != null) {
      print('StorageManager successfully initialized');
    }
    // [dart_NavigineSdk_getStorageManager]
 
    // [dart_NavigineSdk_getRouteLayer]
    // Create RouteLayer for building and drawing routes on the map
    final locationWindow = _locationWindow;
    if (locationWindow != null) {
      _routeLayer = _sdk?.getRouteLayer(locationWindow);
      if (_routeLayer != null) {
        print('RouteLayer successfully initialized');
      }
    }
    // [dart_NavigineSdk_getRouteLayer]
 
    // [dart_NavigineSdk_getGuidanceCamera]
    final routeLayer = _routeLayer;
    if (locationWindow != null && routeLayer != null) {
      _guidanceCamera = _sdk?.getGuidanceCamera(locationWindow, routeLayer);
      // [dart_GuidanceCamera_setMode]
      _guidanceCamera?.setMode(GuidanceCameraMode.FOLLOWING);
      // [dart_GuidanceCamera_setMode]
      // [dart_GuidanceCamera_set2DMode]
      _guidanceCamera?.set2DMode(false);
      // [dart_GuidanceCamera_set2DMode]
      // [dart_GuidanceCamera_mode]
      print('Guidance mode: ${_guidanceCamera?.mode()}');
      // [dart_GuidanceCamera_mode]
      // [dart_GuidanceCamera_instruction]
      final next = _guidanceCamera?.instruction();
      print('Next instruction: ${next?.title} ${next?.distance} m');
      // [dart_GuidanceCamera_instruction]
    }
    // [dart_NavigineSdk_getGuidanceCamera]
 
    // [dart_NavigineSdk_getRouteSimulator]
    if (locationWindow != null) {
      final routeSimulator = _sdk?.getRouteSimulator(locationWindow);
      // [dart_RouteSimulator_setGeometry]
      final walk = LocationPolyline(
        [GlobalPoint(55.751, 37.618), GlobalPoint(55.752, 37.618)],
        null,
      );
      routeSimulator?.setGeometry([walk]);
      // [dart_RouteSimulator_setGeometry]
      // [dart_RouteSimulator_setSpeed]
      routeSimulator?.setSpeed(1.4);
      // [dart_RouteSimulator_setSpeed]
      // [dart_RouteSimulator_start]
      final started = routeSimulator?.start() ?? false;
      print('Route walk started: $started');
      // [dart_RouteSimulator_start]
      // [dart_RouteSimulator_sample]
      final sample = routeSimulator?.sample();
      print('Walk advance: ${sample?.advance} m');
      // [dart_RouteSimulator_sample]
    }
    // [dart_NavigineSdk_getRouteSimulator]
 
    // [dart_NavigineSdk_getMqttSession]
    // Get MqttSession for publishing position data via MQTT
    if (_navigationManager != null) {
      _mqttSession = _sdk?.getMqttSession(_navigationManager!);
      if (_mqttSession != null) {
        print('MqttSession successfully initialized');
      }
    }
    // [dart_NavigineSdk_getMqttSession]
  }

  void printSdkInfo() {
    print('=== Navigine SDK Information ===');
    print('SDK Version: ${NavigineSdk.getVersion()}');
    print('Device ID: ${NavigineSdk.getDeviceId()}');
    print('Relative Time: ${NavigineSdk.getRelativeTime()}');
    print(
      'LocationManager: ${_locationManager != null ? "available" : "unavailable"}',
    );
    print(
      'NavigationManager: ${_navigationManager != null ? "available" : "unavailable"}',
    );
    print('ZoneManager: ${_zoneManager != null ? "available" : "unavailable"}');
    print(
      'RouteManager: ${_routeManager != null ? "available" : "unavailable"}',
    );
    print(
      'AsyncRouteManager: ${_asyncRouteManager != null ? "available" : "unavailable"}',
    );
    print(
      'NotificationManager: ${_notificationManager != null ? "available" : "unavailable"}',
    );
    print(
      'MeasurementManager: ${_measurementManager != null ? "available" : "unavailable"}',
    );
    print(
      'LocationListManager: ${_locationListManager != null ? "available" : "unavailable"}',
    );
    print(
      'StorageManager: ${_storageManager != null ? "available" : "unavailable"}',
    );
    print(
      'MqttSession: ${_mqttSession != null ? "available" : "unavailable"}',
    );
  }

  void demonstrateManagersUsage() {
    print('=== Manager Usage Demonstration ===');
 
    // LocationManager usage example
    if (_locationManager != null) {
      print('LocationManager ready for location operations');
      // Add code here for loading locations, working with them, etc.
    }
 
    // NavigationManager usage example
    if (_navigationManager != null) {
      print('NavigationManager ready for positioning');
      // Add code here for getting position, setting up listeners, etc.
    }
 
    // ZoneManager usage example
    if (_zoneManager != null) {
      print('ZoneManager ready for zone operations');
      // Add code here for setting up zones, handling enter/exit events, etc.
    }
 
    // RouteManager usage example
    if (_routeManager != null) {
      print('RouteManager ready for route building');
      // Add code here for building routes, setting destination points, etc.
    }
 
    // AsyncRouteManager usage example
    if (_asyncRouteManager != null) {
      print('AsyncRouteManager ready for async route operations');
      // Add code here for creating routing sessions, etc.
    }
 
    // NotificationManager usage example
    if (_notificationManager != null) {
      print('NotificationManager ready for notifications');
      // Add code here for setting up beacon notifications, etc.
    }
 
    // MeasurementManager usage example
    if (_measurementManager != null) {
      print('MeasurementManager ready for measurements');
      // Add code here for managing measurement generators, etc.
    }
 
    // LocationListManager usage example
    if (_locationListManager != null) {
      print('LocationListManager ready for location list operations');
      // Add code here for getting available locations list, etc.
    }
 
    // StorageManager usage example
    if (_storageManager != null) {
      print('StorageManager ready for storage operations');
      // Add code here for creating storages, managing data, etc.
    }
 
    // MqttSession usage example
    if (_mqttSession != null) {
      print('MqttSession ready for publishing position data via MQTT');
      // Add code here for connecting to MQTT broker, publishing positions, etc.
    }
  }

  void demonstrateDartFeatures() {
    print('=== Dart Features Demonstration ===');
 
    // Using null-aware operators
    _sdk?.setUserHash('YYYY-YYYY-YYYY-YYYY');
    print('User hash updated');
 
    // Using collection if for conditional element addition
    final managers = <String>[
      'LocationManager',
      'NavigationManager',
      if (_zoneManager != null) 'ZoneManager',
      if (_routeManager != null) 'RouteManager',
      if (_asyncRouteManager != null) 'AsyncRouteManager',
      if (_notificationManager != null) 'NotificationManager',
      if (_measurementManager != null) 'MeasurementManager',
      if (_locationListManager != null) 'LocationListManager',
      if (_storageManager != null) 'StorageManager',
      if (_mqttSession != null) 'MqttSession',
    ];
    print('Available managers: $managers');
 
    // Using map for data transformation
    final sdkInfo = <String, String>{
      'version': NavigineSdk.getVersion(),
      'deviceId': NavigineSdk.getDeviceId(),
      'relativeTime': NavigineSdk.getRelativeTime().toString(),
    };
 
    final infoStrings = sdkInfo.entries.map(
      (entry) => '${entry.key}: ${entry.value}',
    );
    print('SDK information: ${infoStrings.join(', ')}');
 
    // Using where for filtering
    final allManagers = [
      _locationManager,
      _navigationManager,
      _zoneManager,
      _routeManager,
      _asyncRouteManager,
      _notificationManager,
      _measurementManager,
      _locationListManager,
      _storageManager,
      _mqttSession,
    ];
 
    final availableManagers =
        allManagers.where((manager) => manager != null).length;
    print('Available managers count: $availableManagers');
  }

  Future<void> demonstrateAsyncFeatures() async {
    print('=== Async Features Demonstration ===');
 
    // Simulating async operation
    await Future.delayed(Duration(seconds: 1));
    print('Async operation completed');
 
    // Using async/await with error handling
    try {
      await _performAsyncOperation();
    } catch (e) {
      print('Error in async operation: $e');
    }
  }

  Future<void> _performAsyncOperation() async {
    await Future.delayed(Duration(milliseconds: 500));
    print('Additional async operation completed');
  }

  void demonstrateExtensionMethods() {
    print('=== Extension Methods Demonstration ===');
 
    final status = _getManagersStatus();
    print('Managers status: $status');
 
    final isReady = _isSdkReady();
    print('SDK ready for work: $isReady');
  }

  Future<void> runExample() async {
    printSdkInfo();
    demonstrateManagersUsage();
    demonstrateDartFeatures();
    await demonstrateAsyncFeatures();
    demonstrateExtensionMethods();
    createLocationWindowExample();
  }
}

extension NavigineSdkExampleExtension on NavigineSdkExample {
  Map<String, bool> _getManagersStatus() {
    return {
      'LocationManager': _locationManager != null,
      'NavigationManager': _navigationManager != null,
      'ZoneManager': _zoneManager != null,
      'RouteManager': _routeManager != null,
      'AsyncRouteManager': _asyncRouteManager != null,
      'NotificationManager': _notificationManager != null,
      'MeasurementManager': _measurementManager != null,
      'LocationListManager': _locationListManager != null,
      'StorageManager': _storageManager != null,
      'MqttSession': _mqttSession != null,
    };
  }

  bool _isSdkReady() {
    return _sdk != null && _locationManager != null;
  }
}

class NavigineSdkFlutterExample {
  static Future<void> initializeInFlutter() async {
    print('=== Navigine SDK Initialization in Flutter ===');
 
    final example = NavigineSdkExample();
    await example.runExample();
 
    print('Initialization completed');
  }
}

void main() async {
  final example = NavigineSdkExample();
  await example.runExample();
}