ZoneManagerExample.kt

Go to the documentation of this file.

import kotlinx.coroutines.delay
import kotlinx.coroutines.runBlocking
import kotlinx.coroutines.GlobalScope
import kotlinx.coroutines.launch
 
/**
 * ZoneManager usage example for Kotlin
 * Demonstrates working with zone detection, event handling, and zone management
 */
class ZoneManagerExample {
    private var sdk: NavigineSdk? = null
    private var locationManager: LocationManager? = null
    private var navigationManager: NavigationManager? = null
    private var zoneManager: ZoneManager? = null
    private var zoneListener: ZoneListener? = null
 
    init {
        initializeSdk()
        setupZoneListener()
    }
 
    /**
     * Initialize SDK and get managers
     */
    private fun initializeSdk() {
        try {
            // [kotlin_NavigineSdk_getInstance]
            // Get SDK instance
            sdk = NavigineSdk.getInstance()
            // [kotlin_NavigineSdk_getInstance]
 
            // [kotlin_NavigineSdk_setUserHash]
            // Set user hash
            sdk?.setUserHash("USER-HASH-HERE")
            // [kotlin_NavigineSdk_setUserHash]
 
            // [kotlin_NavigineSdk_setServer]
            // Set server URL (optional)
            sdk?.setServer("https://custom.navigine.com")
            // [kotlin_NavigineSdk_setServer]
 
            // [kotlin_NavigineSdk_getLocationManager]
            // Get LocationManager for working with locations
            locationManager = sdk?.getLocationManager()
            // [kotlin_NavigineSdk_getLocationManager]
 
            // [kotlin_NavigineSdk_getNavigationManager]
            // Get NavigationManager for working with navigation
            navigationManager = sdk?.getNavigationManager(locationManager)
            // [kotlin_NavigineSdk_getNavigationManager]
 
            // [kotlin_NavigineSdk_getZoneManager]
            // Get ZoneManager for working with zones
            zoneManager = sdk?.getZoneManager(locationManager, navigationManager)
            // [kotlin_NavigineSdk_getZoneManager]
 
            if (locationManager != null && navigationManager != null && zoneManager != null) {
                println("LocationManager, NavigationManager and ZoneManager successfully initialized")
            }
        } catch (e: Exception) {
            System.err.println("Error initializing SDK: ${e.message}")
        }
    }
 
    /**
     * Setup zone listener
     */
    private fun setupZoneListener() {
        zoneListener = object : ZoneListener() {
            // [kotlin_ZoneListener_onZoneEvent]
            override fun onZoneEvent(zoneEvent: ZoneEvent) {
                println("Zone event detected")
                demonstrateZoneEventUsage(zoneEvent)
            }
            // [kotlin_ZoneListener_onZoneEvent]
        }
    }
 
    /**
     * Demonstrate ZoneManager methods
     */
    fun demonstrateZoneManagerMethods() {
        val manager = zoneManager ?: run {
            System.err.println("ZoneManager not initialized")
            return
        }
 
        val listener = zoneListener ?: return
 
        // [kotlin_ZoneManager_addZoneListener]
        // Add zone listener
        manager.addZoneListener(listener)
        println("Added zone listener")
        // [kotlin_ZoneManager_addZoneListener]
 
        // Simulate some time passing for zone events
        GlobalScope.launch {
            delay(2000)
 
            // [kotlin_ZoneManager_removeZoneListener]
            // Remove zone listener
            manager.removeZoneListener(listener)
            println("Removed zone listener")
            // [kotlin_ZoneManager_removeZoneListener]
        }
    }
 
    /**
     * Demonstrate ZoneEvent usage
     */
    fun demonstrateZoneEventUsage(zoneEvent: ZoneEvent) {
        if (zoneEvent == null) {
            System.err.println("ZoneEvent is null")
            return
        }
 
        // [kotlin_ZoneEvent_getType]
        // Get event type
        val type = zoneEvent.type
        println("Zone event type: $type")
        // [kotlin_ZoneEvent_getType]
 
        // [kotlin_ZoneEvent_getLocationId]
        // Get location ID
        val locationId = zoneEvent.locationId
        println("Zone location ID: $locationId")
        // [kotlin_ZoneEvent_getLocationId]
 
        // [kotlin_ZoneEvent_getSublocationId]
        // Get sublocation ID
        val sublocationId = zoneEvent.sublocationId
        println("Zone sublocation ID: $sublocationId")
        // [kotlin_ZoneEvent_getSublocationId]
 
        // [kotlin_ZoneEvent_getId]
        // Get zone ID
        val id = zoneEvent.id
        println("Zone ID: $id")
        // [kotlin_ZoneEvent_getId]
 
        // [kotlin_ZoneEvent_getName]
        // Get zone name
        val name = zoneEvent.name
        println("Zone name: $name")
        // [kotlin_ZoneEvent_getName]
 
        // [kotlin_ZoneEvent_getAlias]
        // Get zone alias
        val alias = zoneEvent.alias
        println("Zone alias: $alias")
        // [kotlin_ZoneEvent_getAlias]
 
        // [kotlin_ZoneEvent_constructor]
        // Create new zone event
        val newZoneEvent = ZoneEvent(
            ZoneEventType.ENTER,
            12345,
            1,
            100,
            "Test Zone",
            "test_zone"
        )
        println("Created new zone event: ${newZoneEvent.name} (${newZoneEvent.alias})")
        // [kotlin_ZoneEvent_constructor]
    }
 
    /**
     * Demonstrate ZoneEventType enum values
     */
    fun demonstrateZoneEventTypes() {
        // [kotlin_ZoneEventType_values]
        // Get all zone event type values
        val types = ZoneEventType.values()
        println("Available zone event types:")
        types.forEach { type ->
            println("  - $type")
        }
        // [kotlin_ZoneEventType_values]
    }
 
    /**
     * Demonstrate advanced zone management features
     */
    suspend fun demonstrateAdvancedZoneFeatures() {
        println("=== Advanced Zone Features ===")
 
        val manager = zoneManager ?: return
 
        // Add multiple listeners
        val listener1 = object : ZoneListener() {
            override fun onZoneEvent(event: ZoneEvent) {
                println("Listener 1: Zone event - ${event.name}")
            }
        }
 
        val listener2 = object : ZoneListener() {
            override fun onZoneEvent(event: ZoneEvent) {
                println("Listener 2: Zone event - ${event.name}")
            }
        }
 
        // [kotlin_ZoneManager_addZoneListener_2]
        // Add first zone listener
        manager.addZoneListener(listener1)
        println("Added first zone listener")
        // [kotlin_ZoneManager_addZoneListener_2]
 
        delay(1000)
 
        // [kotlin_ZoneManager_addZoneListener_3]
        // Add second zone listener
        manager.addZoneListener(listener2)
        println("Added second zone listener")
        // [kotlin_ZoneManager_addZoneListener_3]
 
        // Wait for zone events
        delay(3000)
 
        // Remove listeners
        // [kotlin_ZoneManager_removeZoneListener_1]
        // Remove first zone listener
        manager.removeZoneListener(listener1)
        println("Removed first zone listener")
        // [kotlin_ZoneManager_removeZoneListener_1]
 
        delay(1000)
 
        // [kotlin_ZoneManager_removeZoneListener_2]
        // Remove second zone listener
        manager.removeZoneListener(listener2)
        println("Removed second zone listener")
        // [kotlin_ZoneManager_removeZoneListener_2]
    }
 
    /**
     * Demonstrate zone event simulation
     */
    fun demonstrateZoneEventSimulation() {
        println("=== Zone Event Simulation ===")
 
        // Create different types of zone events
        val simulatedEvents = listOf(
            ZoneEvent(ZoneEventType.ENTER, 12345, 1, 100, "Entrance Zone", "entrance"),
            ZoneEvent(ZoneEventType.EXIT, 12345, 1, 100, "Entrance Zone", "entrance"),
            ZoneEvent(ZoneEventType.ENTER, 12345, 1, 101, "Meeting Room", "meeting_room"),
            ZoneEvent(ZoneEventType.ENTER, 12345, 1, 102, "Cafeteria", "cafeteria"),
            ZoneEvent(ZoneEventType.EXIT, 12345, 1, 101, "Meeting Room", "meeting_room"),
        )
 
        // Simulate zone events
        simulatedEvents.forEachIndexed { index, event ->
            GlobalScope.launch {
                delay((index + 1) * 1000L)
                println("Simulated zone event: ${event.type} - ${event.name} (${event.alias})")
                demonstrateZoneEventUsage(event)
            }
        }
    }
 
    /**
     * Demonstrate zone listener management
     */
    fun demonstrateZoneListenerManagement() {
        println("=== Zone Listener Management ===")
 
        val manager = zoneManager ?: return
 
        // Create a test listener
        val testListener = object : ZoneListener() {
            override fun onZoneEvent(event: ZoneEvent) {
                println("Test listener received event: ${event.name}")
            }
        }
 
        // Add listener
        manager.addZoneListener(testListener)
        println("Added test zone listener")
 
        // Simulate some time passing
        GlobalScope.launch {
            delay(2000)
 
            // Remove listener
            manager.removeZoneListener(testListener)
            println("Removed test zone listener")
        }
    }
 
    /**
     * Clean up resources
     */
    fun cleanup() {
        val manager = zoneManager
        val listener = zoneListener
        if (manager != null && listener != null) {
            // [kotlin_ZoneManager_removeZoneListener_3]
            // Remove zone listener
            manager.removeZoneListener(listener)
            // [kotlin_ZoneManager_removeZoneListener_3]
        }
    }
 
    /**
     * Main demonstration method
     */
    suspend fun runExample() {
        println("=== ZoneManager Example ===")
 
        demonstrateZoneManagerMethods()
        demonstrateZoneEventTypes()
        demonstrateZoneListenerManagement()
        demonstrateAdvancedZoneFeatures()
        demonstrateZoneEventSimulation()
 
        // Wait a bit for zone events
        delay(5000)
 
        cleanup()
        println("=== Example completed ===")
    }
}
 
/**
 * Function to run the example
 */
fun main() = runBlocking {
    val example = ZoneManagerExample()
    example.runExample()
}