MMIR Framework

Class: LanguageManager

mmir. LanguageManager

new mmir.LanguageManager()

manager/settings/languageManager.js, line 30
A class for managing the language of the application.
It's purpose is to load the controllers and their views / partials and provide functions to find controllers or perform actions or helper-actions. This "class" is structured as a singleton - so that only one instance is in use.

Requires

  • module:mmir.Constants
  • module:mmir.CommonUtils
  • module:mmir.SemanticInterpreter

Classes

setToCompatibilityModeExtension

Methods

determineLanguage(){String}

manager/settings/languageManager.js, line 542
Chooses a language for the application.

The language selection is done as follows:

  1. check if a default language exists
    if it does and if both (!) grammar and dictionary exist for this language, return this language
  2. walk through all languages alphabetically
    1. if for a language both (!) grammar and dictionary exist, return this language memorize the first language with a grammar (do not care, if a dictionary exists)
  3. test if a grammar exists for the default language - do not care about dictionaries - if it does, return the default language
  4. If a language was found (in Step 2.1) return this language
  5. If still no language is returned take the default language if it has a dictionary
  6. If a language exists, take it (the first one)
  7. Take the default language - no matter what
Returns:
determined language

existsDictionary(Language){Boolean}

manager/settings/languageManager.js, line 451
If a dictionary exists for the given language, 'true' is returned. Else the method returns 'false'.
Name Type Description
Language String String, i.e.: en, de
Returns:
if a dictionary exists for given language.

existsGrammar(Language){Boolean}

manager/settings/languageManager.js, line 508
If a JSON grammar file exists for the given language, 'true' is returned. Else the method returns 'false'.
Name Type Description
Language String String, i.e.: en, de
Returns:
if a grammar exists for given language.

existsSpeechConfig(lang){Boolean}

manager/settings/languageManager.js, line 481
If a speech-configuration (file) exists for the given language.
Name Type Description
lang String the language for which existence of the configuration should be checked, e.g. en, de
Returns:
a speech-configuration exists for given language. Otherwise false.

fixLang(providerName, langCode){String}

manager/settings/languageManager.js, line 744
HELPER for dealing with specific language / country code quirks of speech services: Get the language code for a specific ASR or TTS service, that is if the service requires some specific codes/transformations, then the transformed code is retruned by this function (otherwise the unchanged langCode is returned).
Name Type Description
providerName String corrections for: "nuance" | "mary"
langCode String the original language / country code
Returns:
(possibly "fixed") language-setting/-code

getDefaultLanguage(){String}

manager/settings/languageManager.js, line 643
Gets the default language.
Returns:
default language

getDictionary(){Object}

manager/settings/languageManager.js, line 434
Returns the dictionary of the currently used language.
Returns:
JSON object for the dictionary of the currently used language

getLanguage(){String}

manager/settings/languageManager.js, line 630
Gets the language currently used for the translation.
Returns:
current language

getLanguageConfig(pluginId, feature, separator){String}

manager/settings/languageManager.js, line 696
Get the language code setting for a specific plugin. Returns the default setting, if no specific setting for the specified plugin was defined.
Name Type Description
pluginId String
feature String | Array.<String> optional OPTIONAL dot-separate path String or "path Array" This parameter may be omitted, if no separator parameter is used. DEFAULT: "language" (the language feature)
separator String optional OPTIONAL the speparator-string that should be used for separating the country-part and the language-part of the code
Returns:
language-setting/-code

getLanguages(){String}

manager/settings/languageManager.js, line 657
Gets an array of all for the translation available languages.
Returns:
array of all for the translation available languages

getText(textVarName){String}

manager/settings/languageManager.js, line 673
Looks up a keyword in the current dictionary and returns the translation.
Name Type Description
textVarName String The keyword which is to be translated
Returns:
translation of the keyword

init(lang){Promise}

manager/settings/languageManager.js, line 362
Name Type Description
lang String optional OPTIONAL a language code for setting the current language and selecting the corresponding language resources
Returns:
deferred promise that gets resolved when the language manager is initialized

setLanguage(){String}

manager/settings/languageManager.js, line 617
Sets a new language, but only, if the new language is different from the current language.
Returns:
(new) current language