Voice message: After 1 kilometer turn left onto North Blaney Avenue.
Voice message: Now turn left.
Voice message: After 1 kilometer turn right onto Forest Avenue.
Voice message: Now turn right.
Voice message: After 400 meters turn right onto Park Avenue.
Voice message: Now turn right.

// Notifies on messages that can be fed into TTS engines to guide the user with audible instructions.
// The texts can be maneuver instructions or warn on certain obstacles, such as speed cameras.
visualNavigator.setEventTextListener(new EventTextListener() {
    @Override
    public void onEventTextUpdated(@NonNull EventText eventText) {
        // We use the built-in TTS engine to synthesize the localized text as audio.
        voiceAssistant.speak(eventText.text);
        // We can optionally retrieve the associated maneuver. The details will be null if the text contains
        // non-maneuver related information, such as for speed camera warnings.
        if (eventText.type == TextNotificationType.MANEUVER && eventText.maneuverNotificationDetails != null) {
            Maneuver maneuver = eventText.maneuverNotificationDetails.maneuver;
        }
    }
});

// Notifies on messages that can be fed into TTS engines to guide the user with audible instructions.
// The texts can be maneuver instructions or warn on certain obstacles, such as speed cameras.
visualNavigator.eventTextListener =
    EventTextListener { eventText: EventText ->
    // We use the built-in TTS engine to synthesize the localized text as audio.
    voiceAssistant.speak(eventText.text)
    // We can optionally retrieve the associated maneuver. The details will be null if the text contains
    // non-maneuver related information, such as for speed camera warnings.
    if (eventText.type == TextNotificationType.MANEUVER && eventText.maneuverNotificationDetails != null) {
        val maneuver = eventText.maneuverNotificationDetails!!.maneuver
    }
}

private void setupVoiceGuidance() {
    if(this.voiceAssistant == null) {
        this.voiceAssistant = new VoiceAssistant(MainActivity.this);

        ManeuverNotificationOptions maneuverNotificationOptions = new ManeuverNotificationOptions();
        LanguageCode ttsLanguageCode = getLanguageCodeForDevice(VisualNavigator.getAvailableLanguagesForManeuverNotifications());
        // Set the language in which the notifications will be generated.
        maneuverNotificationOptions.language = ttsLanguageCode;
        // Set the measurement system used for distances.
        maneuverNotificationOptions.unitSystem = UnitSystem.METRIC;
        visualNavigator.setManeuverNotificationOptions(maneuverNotificationOptions);
        Log.d(TAG, "LanguageCode for maneuver notifications: " + ttsLanguageCode);

        // Set language to our TextToSpeech engine.
        Locale locale = LanguageCodeConverter.getLocale(ttsLanguageCode);
        if (voiceAssistant.setLanguage(locale)) {
            Log.d(TAG, "TextToSpeech engine uses this language: " + locale);
        } else {
            Log.e(TAG, "TextToSpeech engine does not support this language: " + locale);
        }
    }
}

private fun setupVoiceGuidance(visualNavigator: VisualNavigator) {
    val ttsLanguageCode =
        getLanguageCodeForDevice(VisualNavigator.getAvailableLanguagesForManeuverNotifications())
    val maneuverNotificationOptions = ManeuverNotificationOptions()
    // Set the language in which the notifications will be generated.
    maneuverNotificationOptions.language = ttsLanguageCode
    // Set the measurement system used for distances.
    maneuverNotificationOptions.unitSystem = UnitSystem.METRIC
    visualNavigator.maneuverNotificationOptions = maneuverNotificationOptions
    Log.d(
        TAG,
        "LanguageCode for maneuver notifications: $ttsLanguageCode"
    )

    // Set language to our TextToSpeech engine.
    val locale = LanguageCodeConverter.getLocale(ttsLanguageCode)
    if (voiceAssistant.setLanguage(locale)) {
        Log.d(
            TAG,
            "TextToSpeech engine uses this language: $locale"
        )
    } else {
        Log.e(
            TAG,
            "TextToSpeech engine does not support this language: $locale"
        )
    }
}

private LanguageCode getLanguageCodeForDevice(List<LanguageCode> supportedVoiceSkins) {

    // 1. Determine if preferred device language is supported by our TextToSpeech engine.
    Locale localeForCurrenDevice = Locale.getDefault();
    if (!voiceAssistant.isLanguageAvailable(localeForCurrenDevice)) {
        Log.e(TAG, "TextToSpeech engine does not support: " + localeForCurrenDevice + ", falling back to EN_US.");
        localeForCurrenDevice = new Locale("en", "US");
    }

    // 2. Determine supported voice skins from HERE SDK.
    LanguageCode languageCodeForCurrenDevice = LanguageCodeConverter.getLanguageCode(localeForCurrenDevice);
    if (!supportedVoiceSkins.contains(languageCodeForCurrenDevice)) {
        Log.e(TAG, "No voice skins available for " + languageCodeForCurrenDevice + ", falling back to EN_US.");
        languageCodeForCurrenDevice = LanguageCode.EN_US;
    }

    return languageCodeForCurrenDevice;
}

// Get the language preferably used on this device.
private fun getLanguageCodeForDevice(supportedVoiceSkins: List<LanguageCode>): LanguageCode {
    // 1. Determine if preferred device language is supported by our TextToSpeech engine.

    var localeForCurrenDevice = Locale.getDefault()
    if (!voiceAssistant.isLanguageAvailable(localeForCurrenDevice)) {
        Log.e(
            TAG,
            "TextToSpeech engine does not support: $localeForCurrenDevice, falling back to EN_US."
        )
        localeForCurrenDevice = Locale("en", "US")
    }

    // 2. Determine supported voice skins from HERE SDK.
    var languageCodeForCurrenDevice =
        LanguageCodeConverter.getLanguageCode(localeForCurrenDevice)
    if (!supportedVoiceSkins.contains(languageCodeForCurrenDevice)) {
        Log.e(
            TAG,
            "No voice skins available for $languageCodeForCurrenDevice, falling back to EN_US."
        )
        languageCodeForCurrenDevice = LanguageCode.EN_US
    }

    return languageCodeForCurrenDevice
}

// Get currently set values - or default values, if no values have been set before.
// By default, notifications for cars on highways are sent 1300 meters before the maneuver
// takes place.
ManeuverNotificationTimingOptions carHighwayTimings = navigator.getManeuverNotificationTimingOptions(TransportMode.CAR, TimingProfile.FAST_SPEED);

// Set ManeuverNotificationType.DISTANCE (3rd notification):
// Set a new value for cars on highways and keep all other values unchanged.
carHighwayTimings.distanceNotificationDistanceInMeters = 1500;

// Apply the changes.
navigator.setManeuverNotificationTimingOptions(TransportMode.CAR, TimingProfile.FAST_SPEED, carHighwayTimings);

// By default, we keep all types. If you set an empty list you will disallow generating the texts.
// The names of the type indicate the use case: For example, RANGE is the farthest notification.
// ACTION is the notification when the maneuver takes place.
// And REMINDER and DISTANCE are two optional notifications when approaching the maneuver.
maneuverNotificationOptions.includedNotificationTypes = Arrays.asList(
        ManeuverNotificationType.RANGE, // first notification.
        ManeuverNotificationType.REMINDER, // second notification.
        ManeuverNotificationType.DISTANCE, // third notification.
        ManeuverNotificationType.ACTION); // fourth notification.

// Add phoneme support with SSML.
// Note that phoneme support may not be supported by all TTS engines.
maneuverNotificationOptions.enablePhoneme = true;
maneuverNotificationOptions.notificationFormatOption = NotificationFormatOption.SSML;

After 300 meters turn right onto <lang xml:lang="ENG"><phoneme alphabet="nts"  ph="&quot;wɔːl&quot;striːt" orthmode="ignorepunct">Wall Street</phoneme></lang>.

spatialAudioCuePanning.startAngularPanning(customPanningData, spatialTrajectoryData -> {
    Log.d(SpatialAudioCuePanning.class.getSimpleName(), "Next azimuth:" + spatialTrajectoryData.azimuthInDegrees);
    updatePanning(spatialTrajectoryData);
});