Merge pull request #532 from smartdevicelink/develop

Release/1.6.0

Author: renonick87

examples/js/hello-sdl/index.html

@@ -94,6 +94,11 @@
                     })
                     .setOnError((sdlManager, info) => {
                         console.error('Error from SdlManagerListener: ', info);
+                    })
+                    .setManagerShouldUpdateLifecycleToLanguage((language = null, hmiLanguage = null) => {
+                        return new SDL.manager.lifecycle.LifecycleConfigurationUpdate()
+                                .setAppName('Hello JS')
+                                .setTtsName([new SDL.rpc.structs.TTSChunk().setText('Hello JS')]);
                     });
 
                 this._sdlManager = new SDL.manager.SdlManager(this._appConfig, managerListener);

examples/node/hello-sdl-tcp/index.js

@@ -47,6 +47,7 @@ class AppClient {
             .setAppId(CONFIG.appId)
             .setAppName(CONFIG.appName)
             .setLanguageDesired(SDL.rpc.enums.Language.EN_US)
+            .setHmiDisplayLanguageDesired(SDL.rpc.enums.Language.EN_US)
             .setAppTypes([
                 SDL.rpc.enums.AppHMIType.MEDIA,
             ])
@@ -89,6 +90,11 @@ class AppClient {
             })
             .setOnError((sdlManager, info) => {
                 console.error('Error from SdlManagerListener: ', info);
+            })
+            .setManagerShouldUpdateLifecycleToLanguage((language = null, hmiLanguage = null) => {
+                return new SDL.manager.lifecycle.LifecycleConfigurationUpdate()
+                    .setAppName('Hello JS')
+                    .setTtsName([new SDL.rpc.structs.TTSChunk().setText('Hello JS')]);
             });
 
         this._sdlManager = new SDL.manager.SdlManager(this._appConfig, managerListener);

examples/node/hello-sdl/AppClient.js

@@ -47,6 +47,7 @@ class AppClient {
             .setAppId(CONFIG.appId)
             .setAppName(CONFIG.appName)
             .setLanguageDesired(SDL.rpc.enums.Language.EN_US)
+            .setHmiDisplayLanguageDesired(SDL.rpc.enums.Language.EN_US)
             .setAppTypes([
                 SDL.rpc.enums.AppHMIType.MEDIA,
             ])
@@ -94,6 +95,11 @@ class AppClient {
             })
             .setOnError((sdlManager, info) => {
                 console.error('Error from SdlManagerListener: ', info);
+            })
+            .setManagerShouldUpdateLifecycleToLanguage((language = null, hmiLanguage = null) => {
+                return new SDL.manager.lifecycle.LifecycleConfigurationUpdate()
+                    .setAppName('Hello JS')
+                    .setTtsName([new SDL.rpc.structs.TTSChunk().setText('Hello JS')]);
             });
 
         this._sdlManager = new SDL.manager.SdlManager(this._appConfig, managerListener);

examples/webengine/hello-sdl/index.html

@@ -86,6 +86,11 @@
                     })
                     .setOnError((sdlManager, info) => {
                         this._logMessage('APP:', 'Error from SdlManagerListener: ' + info, true);
+                    })
+                    .setManagerShouldUpdateLifecycleToLanguage((language = null, hmiLanguage = null) => {
+                        return new SDL.manager.lifecycle.LifecycleConfigurationUpdate()
+                            .setAppName('Hello JS')
+                            .setTtsName([new SDL.rpc.structs.TTSChunk().setText('Hello JS')]);
                     });
 
                 this._sdlManager = new SDL.manager.SdlManager(this._appConfig, managerListener);

lib/js/src/manager/LifecycleConfig.js

@@ -218,7 +218,7 @@ class LifecycleConfig {
     }
 
     /**
-     * Get the desired langauge of the application.
+     * Get the desired language of the application.
      * @returns {Language} - A Language enum value.
      */
     getLanguageDesired () {
@@ -237,7 +237,7 @@ class LifecycleConfig {
 
     /**
      * Get the desired HMI Display Language.
-     * @returns {Language} - A Langauge enum value.
+     * @returns {Language} - A Language enum value.
      */
     getHmiDisplayLanguageDesired () {
         return this._hmiDisplayLanguageDesired;

lib/js/src/manager/SdlManager.js

@@ -222,18 +222,29 @@ class SdlManager extends _SdlManagerBase {
      */
     _checkLifecycleConfiguration () {
         const actualLanguage = this._lifecycleManager.getRegisterAppInterfaceResponse().getLanguage();
+        const actualHmiLanguage = this._lifecycleManager.getRegisterAppInterfaceResponse().getHmiDisplayLanguage();
 
-        if (actualLanguage !== null && actualLanguage !== this._lifecycleConfig.getLanguageDesired()) {
+        if ((actualLanguage !== null && actualLanguage !== this._lifecycleConfig.getLanguageDesired())
+            || (actualHmiLanguage !== null && actualHmiLanguage !== this._lifecycleConfig.getHmiDisplayLanguageDesired())) {
             // HMI language doesn't match the app's desired display language
-            const lifecycleConfigUpdate = this._managerListener.managerShouldUpdateLifecycle(actualLanguage);
+            const lifecycleConfigUpdateNew = this._managerListener.managerShouldUpdateLifecycleToLanguage(actualLanguage, actualHmiLanguage);
+            const lifecycleConfigUpdateOld = this._managerListener.managerShouldUpdateLifecycle(actualLanguage);
+            let lifecycleConfigUpdate;
+            const changeRegistration = new ChangeRegistration();
+
+            if (lifecycleConfigUpdateNew === null) {
+                lifecycleConfigUpdate = lifecycleConfigUpdateOld;
+                changeRegistration.setLanguage(actualLanguage)
+                    .setHmiDisplayLanguage(actualLanguage);
+            } else {
+                lifecycleConfigUpdate = lifecycleConfigUpdateNew;
+                changeRegistration.setLanguage(actualLanguage)
+                    .setHmiDisplayLanguage(actualHmiLanguage);
+            }
 
             if (lifecycleConfigUpdate !== null) {
                 // send a ChangeRegistration RPC
-                const changeRegistration = new ChangeRegistration();
-                changeRegistration
-                    .setLanguage(actualLanguage)
-                    .setHmiDisplayLanguage(actualLanguage)
-                    .setAppName(lifecycleConfigUpdate.getAppName())
+                changeRegistration.setAppName(lifecycleConfigUpdate.getAppName())
                     .setNgnMediaScreenAppName(lifecycleConfigUpdate.getShortAppName())
                     .setVrSynonyms(lifecycleConfigUpdate.getVoiceRecognitionCommandNames());
 
@@ -244,7 +255,7 @@ class SdlManager extends _SdlManagerBase {
                 this.sendRpcResolve(changeRegistration)
                     .then((response) => {
                         this._lifecycleConfig.setLanguageDesired(actualLanguage);
-                        this._lifecycleConfig.setHmiDisplayLanguageDesired(actualLanguage);
+                        this._lifecycleConfig.setHmiDisplayLanguageDesired(actualHmiLanguage);
                         if (lifecycleConfigUpdate.getAppName() !== null) {
                             this._lifecycleConfig.setAppName(lifecycleConfigUpdate.getAppName());
                         }
@@ -502,7 +513,7 @@ class SdlManager extends _SdlManagerBase {
     }
 
     /**
-     * Retreives the RAI response from the _LifecycleManager
+     * Retrieves the RAI response from the _LifecycleManager
      * @returns {RegisterAppInterfaceResponse|null} - A RegisterAppInterfaceResponse.
      */
     getRegisterAppInterfaceResponse () {

lib/js/src/manager/SdlManagerListener.js

@@ -42,6 +42,9 @@ class SdlManagerListener {
         this._managerShouldUpdateLifecycle = (language) => {
             return null;
         };
+        this._managerShouldUpdateLifecycleToLanguage = (language, hmiLanguage) => {
+            return null;
+        };
         this._onSystemInfoReceived = null;
     }
 
@@ -77,6 +80,7 @@ class SdlManagerListener {
 
     /**
      * Set the ManagerShouldUpdateLifecycle event callback function.
+     * @deprecated Use setManagerShouldUpdateLifecycleToLanguage instead
      * @param {function} callback - A function to invoke when the event is triggered.
      * @returns {SdlManagerListener} - A reference to this instance to support method chaining.
      */
@@ -85,6 +89,16 @@ class SdlManagerListener {
         return this;
     }
 
+    /**
+     * Set the ManagerShouldUpdateLifecycleToLanguage event callback function.
+     * @param {function} callback - A function to invoke when the event is triggered.
+     * @returns {SdlManagerListener} - A reference to this instance to support method chaining.
+     */
+    setManagerShouldUpdateLifecycleToLanguage (callback) {
+        this._managerShouldUpdateLifecycleToLanguage = callback;
+        return this;
+    }
+
     /**
      * Safely attempts to invoke the OnStart event callback function.
      * @param {SdlManager} sdlManager - A reference to an SdlManager instance.
@@ -118,6 +132,7 @@ class SdlManagerListener {
 
     /**
      * Safely attempts to invoke the ManagerShouldUpdateLifecycle event callback function.
+     * @deprecated Use managerShouldUpdateLifecycleToLanguage instead
      * @param {Language} language - A Language enum value.
      * @returns {LifecycleConfigurationUpdate|null} - A reference to LifecycleConfigurationUpdate instance or null
      */
@@ -128,6 +143,23 @@ class SdlManagerListener {
         return null;
     }
 
+    /**
+     * Called when the SDL manager detected a language mismatch. In case of a language mismatch the
+     * manager should change the apps registration by updating the lifecycle configuration to the
+     * specified language. If the app can support the specified language it should return an Object
+     * of LifecycleConfigurationUpdate, otherwise it should return null to indicate that the language
+     * is not supported.
+     * @param {Language} language - The VR+TTS language of the connected head unit the manager is trying to update the configuration.
+     * @param {Language} hmiLanguage - The HMI display language of the connected head unit the manager is trying to update the configuration.
+     * @returns {LifecycleConfigurationUpdate|null} - A reference to LifecycleConfigurationUpdate instance or null
+     */
+    managerShouldUpdateLifecycleToLanguage (language, hmiLanguage) {
+        if (typeof this._managerShouldUpdateLifecycleToLanguage === 'function') {
+            return this._managerShouldUpdateLifecycleToLanguage(language, hmiLanguage);
+        }
+        return null;
+    }
+
     /**
      * Set the onSystemInfoReceived function.
      * @param {function} listener - A function to be invoked when the event occurs.

lib/js/src/manager/file/filetypes/SdlFile.js

@@ -72,7 +72,7 @@ class SdlFile {
 
     /**
      * Sets the location of the file
-     * @param {String} filePath - a String value representing the the location of the file
+     * @param {String} filePath - a String value representing the location of the file
      * @returns {SdlFile} - A reference to this instance to support method chaining.
      */
     setFilePath (filePath) {
@@ -143,7 +143,7 @@ class SdlFile {
     }
 
     /**
-     * Sets the the name of the static file. Static files comes pre-shipped with the head unit
+     * Sets the name of the static file. Static files comes pre-shipped with the head unit
      * @param {Boolean} staticIcon - a StaticIconName enum value representing the name of a static file that comes pre-shipped with the head unit
      * @returns {SdlFile} - A reference to this instance to support method chaining.
      */
@@ -153,7 +153,7 @@ class SdlFile {
     }
 
     /**
-     * Gets the the name of the static file. Static files comes pre-shipped with the head unit
+     * Gets the name of the static file. Static files comes pre-shipped with the head unit
      * @returns {Boolean} - a StaticIconName enum value representing the name of a static file that comes pre-shipped with the head unit
      */
     isStaticIcon () {

lib/js/src/manager/lifecycle/_LifecycleManager.js

@@ -412,7 +412,7 @@ class _LifecycleManager {
             .setNgnMediaScreenAppName(this._lifecycleConfig.getShortAppName())
             .setAppHMIType(this._lifecycleConfig.getAppTypes())
             .setLanguageDesired(this._lifecycleConfig.getLanguageDesired())
-            .setHmiDisplayLanguageDesired(this._lifecycleConfig.getLanguageDesired())
+            .setHmiDisplayLanguageDesired(this._lifecycleConfig.getHmiDisplayLanguageDesired())
             .setIsMediaApplication(this._lifecycleConfig._isMediaApp)
             .setDayColorScheme(this._lifecycleConfig.getDayColorScheme())
             .setNightColorScheme(this._lifecycleConfig.getNightColorScheme())

lib/js/src/manager/permission/PermissionElement.js

@@ -47,15 +47,15 @@ class PermissionElement {
     }
 
     /**
-     * Retreives the RPC ID
+     * Retrieves the RPC ID
      * @returns {Number} - A numeric FunctionID
      */
     getRpcId () {
         return this._rpcId;
     }
 
     /**
-     * Retreives the permission parameters the developer wishes to track
+     * Retrieves the permission parameters the developer wishes to track
      * @returns {String[]} - An array of parameter strings
      */
     getParameters () {