AANavigationCallback

Callback interface for Android Auto turn-by-turn navigation events.

This interface handles the guidance/navigation lifecycle, from starting navigation to stopping it and resetting the map for tracking mode.

Responsibility

Manages navigation/guidance events:

• Navigation start (user tapped Navigate or Demo)

• Navigation end (user stopped, arrived, or navigation cancelled)

• Map reset after guidance ends

• Demo mode availability query

Callers

Methods in this interface are called by:

• AndroidAutoNavigationScreen: onAANavigationStarted, onAANavigationEnded, onAARequestsMapReset

• AndroidAutoRoutePreviewScreen: isDemoModeEnabled

Phone App Coordination

When navigation starts on AA:

1. AA shows NavigationTemplate with turn-by-turn instructions

2. Phone shows a placeholder ("Navigation running on car display")

When navigation ends:

1. Phone stops its guidance if active

2. Map is reset to tracking mode (overlays cleared, GPS restored)

Usage

class MyCallback : AANavigationCallback {
    override fun onAANavigationStarted(useDemoMode: Boolean) {
        // Start guidance, show placeholder on phone
    }

    override fun onAANavigationEnded() {
        // Stop guidance, return to normal map view
    }

    override fun onAARequestsMapReset() {
        // Clear overlays, reset GPS, start tracking session
    }

    override fun isDemoModeEnabled(): Boolean {
        return settingsRepository.isDemoModeEnabled
    }
}

See also

Inheritors