@situm/cordova 3.15.31 → 3.15.33

package/example/ios/App/App.xcodeproj/project.pbxproj

@@ -353,7 +353,7 @@
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				MARKETING_VERSION = 1.0;
 				OTHER_SWIFT_FLAGS = "$(inherited) \"-D\" \"COCOAPODS\" \"-DDEBUG\"";
-				PRODUCT_BUNDLE_IDENTIFIER = "com.situm.capacitor-example.v1";
+				PRODUCT_BUNDLE_IDENTIFIER = com.situm.capacitorexample;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
 				SWIFT_VERSION = 5.0;
@@ -373,7 +373,7 @@
 				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				MARKETING_VERSION = 1.0;
-				PRODUCT_BUNDLE_IDENTIFIER = "com.situm.capacitor-example.v1";
+				PRODUCT_BUNDLE_IDENTIFIER = com.situm.capacitorexample;
 				PRODUCT_NAME = "$(TARGET_NAME)";
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = "";
 				SWIFT_VERSION = 5.0;

package/example/package-lock.json

@@ -68,7 +68,7 @@
     },
     "..": {
       "name": "@situm/cordova",
-      "version": "3.14.12",
+      "version": "3.15.30",
       "engines": [
         {
           "name": "cordova-android",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@situm/cordova",
-  "version": "3.15.31",
+  "version": "3.15.33",
   "description": "Situm Wayfinding for Capacitor and Cordova. Integrate plug&play indoor navigation experience with floorplans, POIs, routes and turn-by-turn directions in no time. With the power of Situm.",
   "private": false,
   "repository": "https://github.com/situmtech/cordova",

package/plugin.xml

@@ -2,7 +2,7 @@
 
 <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
     id="@situm/cordova"
-    version="3.15.31">
+    version="3.15.33">
     <name>Situm Cordova plugin Official</name>
     <description>This is the stable branch.</description>
     <license>MIT</license>
@@ -50,6 +50,7 @@
         <source-file src="src/android/app/src/main/java/es/situm/plugin/PluginHelper.java" target-dir="src/es/situm/plugin" />
         <source-file src="src/android/app/src/main/java/es/situm/plugin/SitumMapper.java" target-dir="src/es/situm/plugin" />
         <source-file src="src/android/app/src/main/java/es/situm/plugin/DateUtils.java" target-dir="src/es/situm/plugin" />
+        <source-file src="src/android/app/src/main/java/es/situm/plugin/TextToSpeechManager.java" target-dir="src/es/situm/plugin" />
 
     </platform>
 
@@ -93,7 +94,7 @@
             <config>
             </config>
             <pods use-frameworks="false">
-                <pod name="SitumSDK" spec="~> 3.34.8"/>
+                <pod name="SitumSDK" spec="~> 3.34.9"/>
             </pods>
         </podspec>
 
@@ -106,6 +107,7 @@
         <source-file src="src/ios/situmcordovaplugin/Constants.m" />
         <source-file src="src/ios/situmcordovaplugin/SITUtils.m" />
         <source-file src="src/ios/situmcordovaplugin/SITUtils.h" />
-        
+        <source-file src="src/ios/situmcordovaplugin/SITTextToSpeechManager.m" />
+        <source-file src="src/ios/situmcordovaplugin/SITTextToSpeechManager.h" />
     </platform>
 </plugin>

package/src/android/app/build.gradle

@@ -44,7 +44,7 @@ dependencies {
     implementation ('com.googlecode.json-simple:json-simple:1.1.1'){
         exclude group: 'junit', module:'junit'
     }
-    implementation ('es.situm:situm-sdk:3.33.1@aar') {
+    implementation ('es.situm:situm-sdk:3.33.2@aar') {
         transitive = true
     }
     implementation 'org.apache.cordova:framework:10.1.1'

package/src/android/app/src/main/java/es/situm/plugin/PluginHelper.java

@@ -1,9 +1,7 @@
 package es.situm.plugin;
 
-import android.content.Intent;
 import android.graphics.Bitmap;
 import android.util.Log;
-import android.widget.Toast;
 
 import androidx.core.app.ActivityCompat;
 
@@ -50,6 +48,8 @@ import es.situm.sdk.utils.Handler;
 import es.situm.sdk.userhelper.UserHelperColorScheme;
 import es.situm.sdk.v1.SitumEvent;
 
+import es.situm.plugin.TextToSpeechManager;
+
 public class PluginHelper {
 
     private static final String TAG = "PluginHelper";
@@ -64,6 +64,7 @@ public class PluginHelper {
     private volatile NavigationManager nmInstance;
     private RealTimeListener realtimeListener;
     private volatile RealTimeManager rmInstance;
+    private TextToSpeechManager ttsManager;
 
     private Route computedRoute;
     private Location computedLocation;
@@ -71,6 +72,10 @@ public class PluginHelper {
     private CallbackContext callbackEnterGeofences;
     private CallbackContext callbackExitGeofences;
 
+    void setTextToSpeechManager(TextToSpeechManager ttsManager) {
+        this.ttsManager = ttsManager;
+    }
+
     private CommunicationManager getCommunicationManagerInstance() {
         if (cmInstance == null) { //Check for the first time
             synchronized (CommunicationManager.class) {   //Check for the second time.
@@ -109,6 +114,31 @@ public class PluginHelper {
         nmInstance = navigationManager;
     }
 
+    public void onResume() {
+        ttsManager.setCanSpeak(true);
+    }
+
+    public void onPause() {
+        ttsManager.setCanSpeak(false);
+    }
+
+    public void onDestroy() {
+        ttsManager.stop();
+        ttsManager = null;
+        locationListener = null;
+        locationRequest = null;
+        navigationListener = null;
+        navigationRequest = null;
+        cmInstance = null;
+        nmInstance = null;
+        realtimeListener = null;
+        rmInstance = null;
+        computedRoute = null;
+        computedLocation = null;
+        callbackEnterGeofences = null;
+        callbackExitGeofences = null;
+    }
+
     public void getDeviceId(CordovaInterface cordova, CordovaWebView webView, JSONArray args,
             final CallbackContext callbackContext) {
         String deviceId = String.valueOf(SitumSdk.getDeviceID());
@@ -977,4 +1007,47 @@ public class PluginHelper {
             callbackContext.sendPluginResult(new PluginResult(Status.ERROR, e.getMessage()));
         }
     }
+
+    // ----------------------------------
+    // MapView messages: 
+    // ----------------------------------
+
+    public void internalHandleMapViewMessage(
+        CordovaInterface cordova,
+        CordovaWebView webView,
+        JSONArray args,
+        CallbackContext callbackContext
+    ) {
+        if (args.length() != 2) return;
+
+        try {
+            String message = args.optString(0, null);
+            Object rawPayload = args.opt(1);
+            JSONObject payload = null;
+            if (rawPayload == null || "null".equalsIgnoreCase(String.valueOf(rawPayload))) {
+                payload = null;
+            } else if (rawPayload instanceof JSONObject) {
+                payload = (JSONObject) rawPayload;
+            } else if (rawPayload instanceof String) {
+                payload = new JSONObject();
+                payload.put("value", rawPayload);
+            }
+            switch (message) {
+                case "ui.speak_aloud_text":
+                    _handleSpeakAloudText(cordova, payload);
+                    break;
+                // Any other message here...
+                default:
+                    break;
+            }
+            callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK));
+
+        } catch (JSONException e) {
+            callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, e.getMessage()));
+        }
+    }
+
+    private void _handleSpeakAloudText(CordovaInterface cordova, JSONObject payload) {
+        ttsManager.speak(payload);
+    }
 }

package/src/android/app/src/main/java/es/situm/plugin/SitumMapper.java

@@ -271,7 +271,7 @@ class SitumMapper {
 
   static Map<String,String> jsonObjectToMapString(JSONObject jo) throws JSONException {
     Map<String,String> map = new HashMap<String, String>();
-    int length = jo.length();
+    int length = jo != null ? jo.length() : 0;
     for(int i = 0; i<length; i++){
       map.put(jo.names().get(i).toString(),jo.getString(jo.names().get(i).toString()));
     }

package/src/android/app/src/main/java/es/situm/plugin/SitumPlugin.java

@@ -3,6 +3,7 @@
 package es.situm.plugin;
 
 import android.util.Log;
+import android.content.Context;
 
 import java.util.concurrent.TimeUnit;
 
@@ -21,10 +22,14 @@ public class SitumPlugin extends CordovaPlugin {
   private static final String TAG = "SitumPlugin";
 
   private static volatile PluginHelper pluginInstance;
+  private static final Object PLUGIN_LOCK = new Object();
+  
+  private static volatile TextToSpeechManager ttsManager;
+  private static final Object TTS_LOCK = new Object();
 
   private static PluginHelper getPluginInstance() {
     if (pluginInstance == null) { //Check for the first time
-      synchronized (PluginHelper.class) {   //Check for the second time.
+      synchronized (PLUGIN_LOCK) {   //Check for the second time.
         //if there is no instance available... create new one
         if (pluginInstance == null) pluginInstance = new PluginHelper();
       }
@@ -32,12 +37,41 @@ public class SitumPlugin extends CordovaPlugin {
     return pluginInstance;
   }
 
-  public void initialize(CordovaInterface cordova, CordovaWebView webView) {
-    super.initialize(cordova, webView);
+  private static void setupTtsManager(Context context) {
+      if (ttsManager == null) {
+          synchronized (TTS_LOCK) {
+              if(ttsManager == null) ttsManager = new TextToSpeechManager(context);
+          }
+      }
+      getPluginInstance().setTextToSpeechManager(ttsManager);
+  }
+
+  @Override
+  public void pluginInitialize() {
+    super.pluginInitialize();
     Log.d(TAG, "Initializing Situm Plugin");
-    SitumSdk.init(cordova.getActivity());
+    SitumSdk.init(this.cordova.getActivity());
+    setupTtsManager(this.cordova.getActivity());
+  }
+
+  @Override
+  public void onPause(boolean multitasking) {
+    getPluginInstance().onPause();
+  }
+
+  @Override
+  public void onResume(boolean multitasking) {
+    getPluginInstance().onResume();
+  }
+
+  @Override
+  public void onDestroy() {
+    getPluginInstance().onDestroy();
+    pluginInstance = null;
+    ttsManager = null;
   }
 
+  @Override
   public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
     Log.d(TAG, "execute: " + action);
     if (action.equalsIgnoreCase("setUseRemoteConfig")) {
@@ -106,6 +140,8 @@ public class SitumPlugin extends CordovaPlugin {
       getPluginInstance().updateNavigationState(cordova, webView, args, callbackContext);
     } else if(action.equalsIgnoreCase("configureUserHelper")) {
       getPluginInstance().configureUserHelper(cordova, webView, args, callbackContext);
+    } else if(action.equalsIgnoreCase("internalHandleMapViewMessage")) {
+      getPluginInstance().internalHandleMapViewMessage(cordova, webView, args, callbackContext);
     } else {
       getPluginInstance().returnDefaultResponse(callbackContext);
     }

package/src/android/app/src/main/java/es/situm/plugin/TextToSpeechManager.java

@@ -0,0 +1,117 @@
+package es.situm.plugin;
+
+import android.content.Context;
+import android.os.Build;
+import android.speech.tts.TextToSpeech;
+
+import org.json.JSONException;
+import org.json.JSONObject;
+
+import java.util.List;
+import java.util.Locale;
+
+public class TextToSpeechManager implements TextToSpeech.OnInitListener {
+
+    private static final float DEFAULT_SPEECH_RATE_VALUE = 1.0f;
+    private TextToSpeech textToSpeech;
+    private boolean canSpeak = true;
+
+    public TextToSpeechManager(Context context) {
+        String enginePackage = getPreferredTtsEnginePackage(context);
+        if (enginePackage != null) {
+            textToSpeech = new TextToSpeech(context, this, enginePackage);
+        } else {
+            textToSpeech = new TextToSpeech(context, this);
+        }
+    }
+
+    @Override
+    public void onInit(int status) {
+        if (status == TextToSpeech.SUCCESS) {
+            // Establece el idioma (opcional)
+            textToSpeech.setLanguage(Locale.getDefault());
+        }
+    }
+
+    public void speak(JSONObject arguments) {
+        if (!canSpeak) return;
+        if (!arguments.has("text")) return;
+
+        if (arguments.has("lang")) {
+            try {
+                String lang = arguments.getString("lang");
+                textToSpeech.setLanguage(new Locale(lang));
+            } catch (JSONException e) {
+                e.printStackTrace();
+                // DO NOTHING: use the current language.
+            }
+        }
+
+        if (arguments.has("pitch")) {
+            try {
+                float pitch = (float) arguments.getDouble("pitch");
+                textToSpeech.setPitch(pitch);
+            } catch (JSONException e) {
+                e.printStackTrace();
+                // DO NOTHING: use the current pitch.
+            }
+        }
+
+        if (arguments.has("rate")) {
+            try {
+                float rate = (float) arguments.getDouble("rate");
+                textToSpeech.setSpeechRate(convertToAndroidSpeechRate(rate));
+            } catch (JSONException e) {
+                e.printStackTrace();
+                // DO NOTHING: use the current rate.
+            }
+        }
+
+        try {
+            String text = arguments.getString("text");
+            textToSpeech.speak(text, TextToSpeech.QUEUE_FLUSH, null, null);
+        } catch (JSONException e) {
+            e.printStackTrace();
+        }
+    }
+
+    // ui.speak_aloud_text message sends the speech rate in FlutterTts scale [0.0f,1.0f],
+    // so convert it to the Android scale [0.0f,2.0f].
+    private float convertToAndroidSpeechRate(float value) {
+        if (value < 0 || value > 1.0f) {
+            return DEFAULT_SPEECH_RATE_VALUE;
+        }
+        return 2 * value;
+    }
+
+    public void stop() {
+        if (textToSpeech != null) {
+            textToSpeech.stop();
+            textToSpeech.shutdown();
+        }
+    }
+
+    private String getPreferredTtsEnginePackage(Context context) {
+        TextToSpeech ttsTemp = new TextToSpeech(context, status -> {});
+        List<TextToSpeech.EngineInfo> engines = ttsTemp.getEngines();
+        ttsTemp.shutdown();
+
+        String googleTts = "com.google.android.tts";
+        if (Build.MANUFACTURER.equalsIgnoreCase("Samsung")) {
+            for (TextToSpeech.EngineInfo engine : engines) {
+                if (googleTts.equals(engine.name)) {
+                    return googleTts;
+                }
+            }
+        }
+        return null;
+    }
+
+    public void setCanSpeak(boolean value) {
+        // TTS is paused when screen is off, app goes background and MapView gets destroyed
+        canSpeak = value;
+        if (!canSpeak && textToSpeech != null) {
+            textToSpeech.stop();
+        }
+    }
+}

package/src/android/situm.gradle

@@ -12,7 +12,7 @@ allprojects {
 
 dependencies {
     implementation 'com.google.android.gms:play-services-location:16.0.0'
-    implementation('es.situm:situm-sdk:3.33.1@aar') {
+    implementation('es.situm:situm-sdk:3.33.2@aar') {
         transitive = true
     }
 }

package/src/ios/Podfile

@@ -1,5 +1,5 @@
 target 'SitumCordovaPlugin' do
   use_frameworks!
-  platform :ios, '9.0'
-  pod 'SitumSDK', '3.34.8'
+  platform :ios, '12.0'
+  pod 'SitumSDK', '3.34.9'
 end

package/src/ios/situmcordovaplugin/SITTextToSpeechManager.h

@@ -0,0 +1,24 @@
+//
+//  SITTextToSpeechManager.h
+//  Situm Cordova
+//
+
+#import <Foundation/Foundation.h>
+#import <AVFoundation/AVFoundation.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@interface SITTextToSpeechManager : NSObject
+
+- (instancetype)init;
+
+/**
+ Processes and speaks aloud a message that MapView's wants to communicate to the user through the 'ui.speak_aloud_text' javascript message.
+ 
+ @param payload An internal dictionary from within MapView that contains the required information and parameters to be able to speak aloud texts.
+ */
+- (void)speakWithPayload:(NSDictionary<id, id> * _Nullable)payload;
+
+@end
+
+NS_ASSUME_NONNULL_END

package/src/ios/situmcordovaplugin/SitTextToSpeechManager.m

@@ -0,0 +1,68 @@
+//
+//  SITTextToSpeechManager.m
+//  Situm Cordova
+//
+
+#import "SITTextToSpeechManager.h"
+
+@interface SITTextToSpeechManager () <AVSpeechSynthesizerDelegate>
+@property (nonatomic, strong) AVSpeechSynthesizer *synthesizer;
+@end
+
+@implementation SITTextToSpeechManager
+
+- (instancetype)init {
+    self = [super init];
+    if (self) {
+        self.synthesizer = [AVSpeechSynthesizer new];
+        self.synthesizer.delegate = self;
+        if (@available(iOS 13.0, *)) {
+            self.synthesizer.usesApplicationAudioSession = false;
+        }
+    }
+    return self;
+}
+
+- (void)speakWithPayload:(NSDictionary<id,id> *)payload {
+    
+    if (![payload isKindOfClass:[NSDictionary class]]) return;
+    
+    NSString *text = payload[@"text"];
+    NSString *lang = payload[@"lang"];
+    NSNumber *pitchNum = payload[@"pitch"];
+    NSNumber *rateNum  = payload[@"rate"];
+    
+    if (![text isKindOfClass:[NSString class]] ||
+        ![lang isKindOfClass:[NSString class]] ||
+        ![pitchNum isKindOfClass:[NSNumber class]] ||
+        ![rateNum isKindOfClass:[NSNumber class]]) {
+        return;
+    }
+    
+    float pitch = pitchNum.floatValue;
+    float rate  = rateNum.floatValue;
+    
+    [self speakText:text language:lang rate:rate pitch:pitch];
+}
+
+- (void)speakText:(NSString *)text language:(NSString *)language rate:(float)rate pitch:(float)pitch {
+    if (text.length == 0) return;
+    
+    AVSpeechUtterance *utt = [[AVSpeechUtterance alloc] initWithString:text];
+    utt.rate = rate;
+    utt.pitchMultiplier = pitch;
+    
+    AVSpeechSynthesisVoice *voice = [AVSpeechSynthesisVoice voiceWithLanguage:language];
+    if (voice) {
+        utt.voice = voice;
+    }
+    
+    dispatch_async(dispatch_get_main_queue(), ^{
+        if ([self.synthesizer isSpeaking]) {
+            [self.synthesizer stopSpeakingAtBoundary:AVSpeechBoundaryImmediate];
+        }
+        [self.synthesizer speakUtterance:utt];
+    });
+}
+
+@end

package/src/ios/situmcordovaplugin/SitumPlugin.h

@@ -36,6 +36,7 @@
 - (void)fetchPoiCategoryIconSelected:(CDVInvokedUrlCommand *)command;
 - (void)invalidateCache:(CDVInvokedUrlCommand *)command;
 - (void)requestDirections:(CDVInvokedUrlCommand *)command;
+- (void)internalHandleMapViewMessage:(CDVInvokedUrlCommand *)command;
 // Realtime
 - (void)requestRealTimeUpdates:(CDVInvokedUrlCommand *)command;
 - (void)removeRealTimeUpdates:(CDVInvokedUrlCommand *)command;

package/src/ios/situmcordovaplugin/SitumPlugin.m

@@ -1,6 +1,7 @@
 #import "SitumPlugin.h"
 #import "SitumLocationWrapper.h"
 #import "SITUtils.h"
+#import "SITTextToSpeechManager.h"
 
 
 #import <Cordova/CDVAvailability.h>
@@ -17,6 +18,7 @@ static NSString *DEFAULT_SITUM_LOG = @"SitumSDK >>: ";
 @interface SitumPlugin() {}
         
 @property (nonatomic, strong) SITRoute *computedRoute;
+@property (nonatomic, strong) SITTextToSpeechManager *ttsManager;
 
 @end
 
@@ -122,7 +124,7 @@ static NSString *DEFAULT_SITUM_LOG = @"SitumSDK >>: ";
         if (IS_LOG_ENABLED) {
             NSLog(@"%@", [NSString stringWithFormat: @"%@ %@ Fetching buildings returned values", DEFAULT_SITUM_LOG, operation]);
         }
-        NSArray *buildings = [mapping valueForKey:ResultsKey];
+        NSArray *buildings = [[mapping valueForKey:ResultsKey] copy];
         CDVPluginResult* pluginResult = nil;
         if (buildings.count == 0) {
             if (IS_LOG_ENABLED) {
@@ -628,6 +630,60 @@ static NSString *DEFAULT_SITUM_LOG = @"SitumSDK >>: ";
     [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
 }
 
+// MapView messages:
+
+- (void)internalHandleMapViewMessage:(CDVInvokedUrlCommand *)command {
+    if (command.arguments.count != 2) {
+        return;
+    }
+    
+    @try {
+        id message = command.arguments[0];
+        id rawPayload = command.arguments[1];
+        NSDictionary *payload = nil;
+
+        if (rawPayload == [NSNull null] ||
+            ([rawPayload isKindOfClass:[NSString class]] &&
+             [((NSString *)rawPayload).lowercaseString isEqualToString:@"null"])) {
+            payload = nil;
+        } else if ([rawPayload isKindOfClass:[NSDictionary class]]) {
+            payload = rawPayload;
+        } else if ([rawPayload isKindOfClass:[NSString class]]) {
+            payload = @{ @"value": rawPayload };
+        }
+
+        NSDictionary *handlers = @{
+            @"ui.speak_aloud_text": ^{
+                [self handleSpeakAloudText:payload];
+            },
+            // Any other MapView message that should be handled natively...
+        };
+
+        void (^handler)(void) = handlers[message];
+        if (handler) handler();
+
+        CDVPluginResult *pluginResult =
+            [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
+        [self.commandDelegate sendPluginResult:pluginResult
+                                    callbackId:command.callbackId];
+
+    }
+    @catch (NSException *exception) {
+        CDVPluginResult *pluginResult =
+            [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR
+                               messageAsString:exception.reason];
+        [self.commandDelegate sendPluginResult:pluginResult
+                                    callbackId:command.callbackId];
+    }
+}
+
+- (void)handleSpeakAloudText:(NSDictionary *)payload {
+    if (!_ttsManager) {
+        _ttsManager = [[SITTextToSpeechManager alloc] init];
+    }
+    [self.ttsManager speakWithPayload:payload];
+}
+
 // Realtime 
 - (void)requestRealTimeUpdates:(CDVInvokedUrlCommand *)command {
     realtimeCallbackId = command.callbackId;

package/www/map-view-controller.js

@@ -76,7 +76,6 @@ class MapViewControllerImpl {
         this._navigationType = 'sdk';
       }
     }
-     
   }
 
   _setOnLoadCallback(callback) {
@@ -152,16 +151,7 @@ class MapViewControllerImpl {
   _handleMapViewMessages(m) {
     switch (m.type) {
       case 'app.map_is_ready':
-        if (
-          this._onLoadCallback &&
-          typeof this._onLoadCallback === 'function'
-        ) {
-          this._onLoadCallback(this);
-          console.debug('Map is ready!');
-        }
-        if (this._navigationType) {
-          this._sendNavigationConfig(this._navigationType);
-        }
+        this._handleMapIsReady();
         break;
       case 'cartography.poi_selected':
         console.debug(`poi (${m.payload.identifier}) was selected`);
@@ -200,12 +190,31 @@ class MapViewControllerImpl {
       case 'viewer.navigation.stopped':
         this._onViewerNavigationStopped(m.payload);
         break;
+      case 'ui.speak_aloud_text': 
+      // case ...: Add here any other message that must be delegated to the native side.
+        this._internalHandleMapViewMessage(m.type, m.payload);
+        break;
       default:
         console.debug('Got unmanaged message: ', m);
         break;
     }
   }
 
+  _handleMapIsReady() {
+    if (this._onLoadCallback &&
+        typeof this._onLoadCallback === 'function') {
+      this._onLoadCallback(this);
+      console.debug('Map is ready!');
+    }
+    if (this._navigationType) {
+      this._sendNavigationConfig(this._navigationType);
+    }
+    this._sendMessageToViewer('app.set_config_item', [
+      {key: "internal.tts.engine", value: "mobile"},
+      // Any other config item here...
+    ]);
+  }
+
   // Fetch the given building and return it or undefined if not found.
   _ensureBuilding(buildingId, callback) {
     if (this._buildings) {
@@ -384,7 +393,9 @@ class MapViewControllerImpl {
     Situm.updateNavigationState(externalNavigation,  () => {}, () => {});
   }
 
-
+  _internalHandleMapViewMessage(message, webPayload) {
+    Situm.internalHandleMapViewMessage(message, webPayload);
+  }
 
   // ==================================================
   // ACTIONS