NavigineSdkExample.m

Go to the documentation of this file.

#import <Foundation/Foundation.h>
#import "NCNavigineSdk.h"
#import "NCLocationManager.h"
#import "NCNavigationManager.h"
#import "NCZoneManager.h"
#import "NCRouteManager.h"
#import "NCAsyncRouteManager.h"
#import "NCNotificationManager.h"
#import "NCMeasurementManager.h"
#import "NCLocationListManager.h"
#import "NCLocationWindow.h"
#import "NCRouteLayer.h"
#import "NCGuidanceCamera.h"
#import "NCMqttSession.h"

@interface NavigineSdkExample : NSObject
 
@property (nonatomic, strong) NCNavigineSdk *sdk;
@property (nonatomic, strong) NCLocationManager *locationManager;
@property (nonatomic, strong) NCNavigationManager *navigationManager;
@property (nonatomic, strong) NCZoneManager *zoneManager;
@property (nonatomic, strong) NCRouteManager *routeManager;
@property (nonatomic, strong) NCAsyncRouteManager *asyncRouteManager;
@property (nonatomic, strong) NCNotificationManager *notificationManager;
@property (nonatomic, strong) NCMeasurementManager *measurementManager;
@property (nonatomic, strong) NCLocationListManager *locationListManager;
@property (nonatomic, strong) NCStorageManager *storageManager;
@property (nonatomic, strong) NCMqttSession *mqttSession;
@property (nonatomic, strong) NCLocationWindow *locationWindow;
@property (nonatomic, strong) NCRouteLayer *routeLayer;
@property (nonatomic, strong) NCGuidanceCamera *guidanceCamera;
 
- (void)initializeSdk;
- (void)initializeManagers;
- (void)createLocationWindowExample;
- (void)printSdkInfo;
- (void)demonstrateManagersUsage;
- (void)runExample;
 
@end
 
@implementation NavigineSdkExample
 
- (instancetype)init {
    self = [super init];
    if (self) {
        [self initializeSdk];
    }
    return self;
}

    - (void)initializeSdk {
        @try {
            // [objc_NavigineSdk_getInstance]
            // Get SDK instance
            self.sdk = [NCNavigineSdk getInstance];
            // [objc_NavigineSdk_getInstance]
 
            if (!self.sdk) {
                NSLog(@"Error: failed to get NavigineSdk instance");
                return;
            }
 
            // [objc_NavigineSdk_getVersion]
            // Get SDK version
            NSLog(@"Navigine SDK Version: %@", [NCNavigineSdk getVersion]);
            // [objc_NavigineSdk_getVersion]
 
            // [objc_NavigineSdk_getDeviceId]
            // Get device ID
            NSLog(@"Device ID: %@", [NCNavigineSdk getDeviceId]);
            // [objc_NavigineSdk_getDeviceId]
 
            // [objc_NavigineSdk_getRelativeTime]
            // Get relative time
            NSLog(@"Relative Time: %lld", [NCNavigineSdk getRelativeTime]);
            // [objc_NavigineSdk_getRelativeTime]
 
            // [objc_NavigineSdk_setUserHash]
            // Set user hash (authorization token)
            [self.sdk setUserHash:@"XXXX-XXXX-XXXX-XXXX"];
            // [objc_NavigineSdk_setUserHash]
 
        
    // [objc_NavigineSdk_getUserAgent]
    NSLog(@"User-Agent: %@", [NCNavigineSdk getUserAgent]);
    // [objc_NavigineSdk_getUserAgent]
 
    // [objc_NavigineSdk_reset]
    [_sdk reset];
    NSLog(@"SDK reset to initial state");
    // [objc_NavigineSdk_reset]
 
    // [objc_NavigineSdk_setServer]
            // Set server URL (optional)
            [self.sdk setServer:@"https://custom.navigine.com"];
    // [objc_NavigineSdk_setServer]
 
            // Initialize managers
            [self initializeManagers];
 
        } @catch (NSException *exception) {
            NSLog(@"SDK initialization error: %@", exception.reason);
        }
    }

    - (void)initializeManagers {
        // [objc_NavigineSdk_getLocationManager]
        // Get LocationManager for working with locations
        self.locationManager = [self.sdk getLocationManager];
        if (self.locationManager) {
            NSLog(@"LocationManager successfully initialized");
        }
        // [objc_NavigineSdk_getLocationManager]
 
        // [objc_NavigineSdk_getNavigationManager]
        // Get NavigationManager for navigation
        if (self.locationManager) {
            self.navigationManager = [self.sdk getNavigationManager:self.locationManager];
            if (self.navigationManager) {
                NSLog(@"NavigationManager successfully initialized");
            }
        }
        // [objc_NavigineSdk_getNavigationManager]
 
        // [objc_NavigineSdk_getZoneManager]
        // Get ZoneManager for working with zones
        if (self.navigationManager) {
            self.zoneManager = [self.sdk getZoneManager:self.navigationManager];
            if (self.zoneManager) {
                NSLog(@"ZoneManager successfully initialized");
            }
        }
        // [objc_NavigineSdk_getZoneManager]
 
        // [objc_NavigineSdk_getRouteManager]
        // Get RouteManager for building routes
        if (self.locationManager && self.navigationManager) {
            self.routeManager = [self.sdk getRouteManager:self.locationManager
                                       navigationManager:self.navigationManager];
            if (self.routeManager) {
                NSLog(@"RouteManager successfully initialized");
            }
        }
        // [objc_NavigineSdk_getRouteManager]
 
        // [objc_NavigineSdk_getAsyncRouteManager]
        // Get AsyncRouteManager for async route operations
        if (self.locationManager && self.navigationManager) {
            self.asyncRouteManager = [self.sdk getAsyncRouteManager:self.locationManager
                                                 navigationManager:self.navigationManager];
            if (self.asyncRouteManager) {
                NSLog(@"AsyncRouteManager successfully initialized");
            }
        }
        // [objc_NavigineSdk_getAsyncRouteManager]
 
        // [objc_NavigineSdk_getNotificationManager]
        // Get NotificationManager for notifications
        if (self.locationManager) {
            self.notificationManager = [self.sdk getNotificationManager:self.locationManager];
            if (self.notificationManager) {
                NSLog(@"NotificationManager successfully initialized");
            }
        }
        // [objc_NavigineSdk_getNotificationManager]
 
        // [objc_NavigineSdk_getMeasurementManager]
        // Get MeasurementManager for measurements
        if (self.locationManager) {
            self.measurementManager = [self.sdk getMeasurementManager:self.locationManager];
            if (self.measurementManager) {
                NSLog(@"MeasurementManager successfully initialized");
            }
        }
        // [objc_NavigineSdk_getMeasurementManager]
 
        // [objc_NavigineSdk_getLocationListManager]
        // Get LocationListManager for location list operations
        self.locationListManager = [self.sdk getLocationListManager];
        if (self.locationListManager) {
            NSLog(@"LocationListManager successfully initialized");
        }
        // [objc_NavigineSdk_getLocationListManager]
 
        // [objc_NavigineSdk_getStorageManager]
        // Get StorageManager for working with storages
        self.storageManager = [self.sdk getStorageManager];
        if (self.storageManager) {
            NSLog(@"StorageManager successfully initialized");
        }
        // [objc_NavigineSdk_getStorageManager]
 
        // [objc_NavigineSdk_getRouteLayer]
        // Create RouteLayer for building and drawing routes on the map
        if (self.locationWindow) {
            self.routeLayer = [self.sdk getRouteLayer:self.locationWindow];
            if (self.routeLayer) {
                NSLog(@"RouteLayer successfully initialized");
            }
        }
        // [objc_NavigineSdk_getRouteLayer]
 
        // [objc_NavigineSdk_getGuidanceCamera]
        if (self.locationWindow && self.routeLayer) {
            self.guidanceCamera = [self.sdk getGuidanceCamera:self.locationWindow routeLayer:self.routeLayer];
            // [objc_GuidanceCamera_setMode]
            [self.guidanceCamera setMode:NCGuidanceCameraModeFOLLOWING];
            // [objc_GuidanceCamera_setMode]
            // [objc_GuidanceCamera_set2DMode]
            [self.guidanceCamera set2DMode:NO];
            // [objc_GuidanceCamera_set2DMode]
            // [objc_GuidanceCamera_mode]
            NSLog(@"Guidance mode: %ld", (long)[self.guidanceCamera mode]);
            // [objc_GuidanceCamera_mode]
            // [objc_GuidanceCamera_instruction]
            NCRouteInstruction *next = [self.guidanceCamera instruction];
            if (next) {
                NSLog(@"Next instruction: %@ %.0f m", next.title, next.distance);
            }
            // [objc_GuidanceCamera_instruction]
        }
        // [objc_NavigineSdk_getGuidanceCamera]
 
        // [objc_NavigineSdk_getRouteSimulator]
        if (self.locationWindow) {
            NCRouteSimulator *routeSimulator = [self.sdk getRouteSimulator:self.locationWindow];
            // [objc_RouteSimulator_setGeometry]
            NCLocationPolyline *walk = [[NCLocationPolyline alloc] initWithPoints:@[
                [[NCGlobalPoint alloc] initWithLatitude:55.751 longitude:37.618],
                [[NCGlobalPoint alloc] initWithLatitude:55.752 longitude:37.618],
            ] sublocationId:nil];
            [routeSimulator setGeometry:@[walk]];
            // [objc_RouteSimulator_setGeometry]
            // [objc_RouteSimulator_setSpeed]
            [routeSimulator setSpeed:1.4f];
            // [objc_RouteSimulator_setSpeed]
            // [objc_RouteSimulator_start]
            BOOL started = [routeSimulator start];
            NSLog(@"Route walk started: %@", started ? @"YES" : @"NO");
            // [objc_RouteSimulator_start]
            // [objc_RouteSimulator_sample]
            NCRouteSimulatorSample *sample = [routeSimulator sample];
            if (sample) {
                NSLog(@"Walk advance: %f m", sample.advance);
            }
            // [objc_RouteSimulator_sample]
        }
        // [objc_NavigineSdk_getRouteSimulator]
 
        // [objc_NavigineSdk_getMqttSession]
        // Get MqttSession for publishing position data via MQTT
        if (self.navigationManager) {
            self.mqttSession = [self.sdk getMqttSession:self.navigationManager];
            if (self.mqttSession) {
                NSLog(@"MqttSession successfully initialized");
            }
        }
        // [objc_NavigineSdk_getMqttSession]
    }

    - (void)printSdkInfo {
        NSLog(@"=== Navigine SDK Information ===");
        NSLog(@"SDK Version: %@", [NCNavigineSdk getVersion]);
        NSLog(@"Device ID: %@", [NCNavigineSdk getDeviceId]);
        NSLog(@"Relative Time: %lld", [NCNavigineSdk getRelativeTime]);
        NSLog(@"LocationManager: %@", self.locationManager ? @"available" : @"unavailable");
        NSLog(@"NavigationManager: %@", self.navigationManager ? @"available" : @"unavailable");
        NSLog(@"ZoneManager: %@", self.zoneManager ? @"available" : @"unavailable");
        NSLog(@"RouteManager: %@", self.routeManager ? @"available" : @"unavailable");
        NSLog(@"AsyncRouteManager: %@", self.asyncRouteManager ? @"available" : @"unavailable");
        NSLog(@"NotificationManager: %@", self.notificationManager ? @"available" : @"unavailable");
        NSLog(@"MeasurementManager: %@", self.measurementManager ? @"available" : @"unavailable");
        NSLog(@"LocationListManager: %@", self.locationListManager ? @"available" : @"unavailable");
        NSLog(@"StorageManager: %@", self.storageManager ? @"available" : @"unavailable");
        NSLog(@"MqttSession: %@", self.mqttSession ? @"available" : @"unavailable");
    }

    - (void)demonstrateManagersUsage {
        NSLog(@"=== Manager Usage Demonstration ===");
 
        // LocationManager usage example
        if (self.locationManager) {
            NSLog(@"LocationManager ready for location operations");
            // Add code here for loading locations, working with them, etc.
        }
 
        // NavigationManager usage example
        if (self.navigationManager) {
            NSLog(@"NavigationManager ready for positioning");
            // Add code here for getting position, setting up listeners, etc.
        }
 
        // ZoneManager usage example
        if (self.zoneManager) {
            NSLog(@"ZoneManager ready for zone operations");
            // Add code here for setting up zones, handling enter/exit events, etc.
        }
 
        // RouteManager usage example
        if (self.routeManager) {
            NSLog(@"RouteManager ready for route building");
            // Add code here for building routes, setting destination points, etc.
        }
 
        // AsyncRouteManager usage example
        if (self.asyncRouteManager) {
            NSLog(@"AsyncRouteManager ready for async route operations");
            // Add code here for creating routing sessions, etc.
        }
 
        // NotificationManager usage example
        if (self.notificationManager) {
            NSLog(@"NotificationManager ready for notifications");
            // Add code here for setting up beacon notifications, etc.
        }
 
        // MeasurementManager usage example
        if (self.measurementManager) {
            NSLog(@"MeasurementManager ready for measurements");
            // Add code here for managing measurement generators, etc.
        }
 
        // LocationListManager usage example
        if (self.locationListManager) {
            NSLog(@"LocationListManager ready for location list operations");
            // Add code here for getting available locations list, etc.
        }
 
        // StorageManager usage example
        if (self.storageManager) {
            NSLog(@"StorageManager ready for storage operations");
            // Add code here for creating storages, managing data, etc.
        }
 
        // MqttSession usage example
        if (self.mqttSession) {
            NSLog(@"MqttSession ready for publishing position data via MQTT");
            // Add code here for connecting to MQTT broker, publishing positions, etc.
        }
    }

    - (void)demonstrateObjectiveCFeatures {
        NSLog(@"=== Objective-C Features Demonstration ===");
 
        // Using blocks for async operations
        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
            // Async operation
            dispatch_async(dispatch_get_main_queue(), ^{
                NSLog(@"Async operation completed");
            });
        });
 
        // Using KVO (Key-Value Observing) - example
        [self addObserver:self forKeyPath:@"locationManager" options:NSKeyValueObservingOptionNew context:nil];
 
        // Using categories (if they were defined)
        // [self.sdk performCustomOperation];
 
        // Using selectors
        SEL selector = @selector(printSdkInfo);
        if ([self respondsToSelector:selector]) {
            [self performSelector:selector];
        }
    }

    - (void)observeValueForKeyPath:(NSString *)keyPath
                          ofObject:(id)object
                            change:(NSDictionary<NSKeyValueChangeKey,id> *)change
                           context:(void *)context {
        if ([keyPath isEqualToString:@"locationManager"]) {
            NSLog(@"LocationManager changed");
        }
    }

    - (void)runExample {
        [self printSdkInfo];
        [self demonstrateManagersUsage];
        [self demonstrateObjectiveCFeatures];
    }
 
- (void)dealloc {
    [self removeObserver:self forKeyPath:@"locationManager"];
}
 
@end

int main(int argc, const char * argv[]) {
    @autoreleasepool {
        NavigineSdkExample *example = [[NavigineSdkExample alloc] init];
        [example runExample];
    }
    return 0;
}