Cordova MLKit Translation


Cordova Plugin that implements MLKit Translation and Language Identification features.

Supports both iOS and Android.

This plugin uses Google's MLKit On-device Translation services, so make sure you follow the steps to create a firebase project (Android | iOS) up to step 3 (where you get the google-services.json or GoogleService-Info.plist). Ignore if you already have google-services.json or GoogleService-Info.plist files.

Additionally, make sure you follow Google's usage guidelines for MLKit usage.

For translation, MLKit and by extension this plugin support the following languages.

For language identification, the plugin supports the following languages.

#### Table of Contents

- Installation
- Version support
- Dependencies
- Variables
- API
- translate
- identifyLanguage
- getDownloadedModels
- getAvailableModels
- downloadModel
- deleteModel

Installation

- Install the plugin by adding it to your project's config.xml:

``

`

or

`
cordova plugin add cordova-plugin-mlkit-translate
`

- (Optional) If you're using ionic, make sure you use the Ionic native wrapper.
`
npm install @ionic-native/mlkit-translate
`

- Make sure you have your google-services.json or GoogleService-Info.plist file in your project's root folder.

$3

- cordova >=9
- cordova-android >=8
- cordova-ios >=5

$3

- This plugin depends on cordova-plugin-firebasex on Android.
- This plugin depends on cordova-plugin-add-swift-support on iOS.

Variables

These variables are android only

| Variable | Default |
| :----------------------------------------: | :-----: |
| FIREBASE_ML_NATURAL_LANGUAGE_VERSION | 22.0.0 |
| FIREBASE_ML_NATURAL_LANGUAGE_MODEL_VERSION | 20.0.7 |
| FIREBASE_ML_NATURAL_LANGUAGE_ID_VERSION | 20.0.7 |

API

You can access all these methods via the window["MLKitTranslate"] object.

If you're using the Ionic Native wrapper, then add the plugin to your module

`
import { MLKitTranslate } from '@ionic-native/mlkit-translate/ngx';
@NgModule({
declarations: [AppComponent],
entryComponents: [],
imports: [
...
],
providers: [
...
MLKitTranslate,
...
],
bootstrap: [AppComponent]
})
export class AppModule {}
`

And then inject it into the component you want.

`
import { MLKitTranslate } from '@ionic-native/ml-kit-translate';

constructor(private mlkitTranslate: MLKitTranslate) { }
...
`

#### translate

Translates text from one language to another. Requires the source and target languages need to be downloaded. If not the languages are downloaded in the background automatically.

##### Parameters

- {string} text - text to be translated
- {string} targetLanguage - language code of the language to translate to
- {string} sourceLanguage - (optional) language code of the language to translate from, if not present the language is inferred.
- {function} success - (promisified in ionic native wrapper) callback function which takes a parameter data which will be invoked on success
- {function} error - (promisified in ionic native wrapper) callback function which takes a parameter err which will be invoked on failure

##### Example

`
window["MLKitTranslate"].translate("hello", "es", "en",
(data)=>console.log(Translated text is ${data}),
(err)=>console.log("Something went wrong with the translation")
})
// prints Translated text is hola
`

with Ionic Native

`
this.mlkitTranslate.translate("hello", "es", "en").then(translatedText=>{
console.log(console.log(Translated text is ${translatedText}))
})
// prints Translated text is hola
`

#### identifyLanguage

Determines the language of a string of text.

##### Parameters

- {string} text - text to be identified
- {function} success - (promisified in ionic native wrapper) callback function which takes a parameter data which will be invoked on success
- {function} error - (promisified in ionic native wrapper) callback function which takes a parameter err which will be invoked on failure

#### Data format

Success data will be a language object with two properties

- {string} code - BCP-47 language code
- {string} displayName - Name of the language

##### Example

`
window["MLKitTranslate"].identifyLanguage("hello",
(data)=>console.log("Identified text is", data),
(err)=>console.log("Something went wrong with the translation")
})

// prints Identified text is {"code": "en", "displayName": "English"}
`

or with Ionic Native

`
this.mlkitTranslate.identifyLanguage("hello").then(lang=>{
console.log("Identified text is ", lang);
})

// prints Identified text is {"code": "en", "displayName": "English"}
`

#### getDownloadedModels

List of language models that have been downloaded to the device.

##### Parameters

- {function} success - (promisified in ionic native wrapper) callback function which takes a parameter data which will be invoked on success
- {function} error - (promisified in ionic native wrapper) callback function which takes a parameter err which will be invoked on failure

##### Data format

Success data will be an array with language objects (see above)

##### Example

`
window["MLKitTranslate"].getDownloadedModels(
(data)=>console.log(data),
(err)=>console.log(err)
})

// prints [{"code": "en", "displayName": "English"}]
`

or with Ionic Native

`
this.mlkitTranslate.getDownloadedModels().then(langs=>{
console.log(langs);
})

// prints [{"code": "en", "displayName": "English"}]
`

#### getAvailableModels

List of language models that can be downloaded.

##### Parameters

- {function} success - (promisified in ionic native wrapper) callback function which takes a parameter data which will be invoked on success
- {function} error - (promisified in ionic native wrapper) callback function which takes a parameter err which will be invoked on failure

##### Data format

Success data will be an array with language objects (see above)

##### Example

`
window["MLKitTranslate"].getAvailableModels(
(data)=>console.log(data),
(err)=>console.log(err)
})

// prints [{"code": "en", "displayName": "English"}, {"code", "es", "displayName": "Spanish"}, ...]
`

or with Ionic Native

`
this.mlkitTranslate.getAvailableModels().then(langs=>{
console.log(langs);
})

// prints [{"code": "en", "displayName": "English"}, {"code", "es", "displayName": "Spanish"}, ...]
`

#### downloadModel

Downloads a specified language model.

##### Parameters

- {string} code - BCP-47 language code of the language to download
- {function} success - (promisified in ionic native wrapper) callback function which takes a parameter data which will be invoked on success
- {function} error - (promisified in ionic native wrapper) callback function which takes a parameter err which will be invoked on failure

##### Data format

Success data will be a language object of the downloaded language.

##### Example

`
window["MLKitTranslate"].downloadModel("es",
(data)=>console.log(data),
(err)=>console.log(err)
})

// prints {"code", "es", "displayName": "Spanish"}
`

or with Ionic Native

`
this.mlkitTranslate.downloadModel("es").then(lang=>{
console.log(langs);
})

// prints {"code", "es", "displayName": "Spanish"}
`

#### deleteModel

Delete a specified language model.

##### Parameters

- {string} code - BCP-47 language code of the language to delete
- {function} success - (promisified in ionic native wrapper) callback function which takes a parameter data which will be invoked on success
- {function} error - (promisified in ionic native wrapper) callback function which takes a parameter err which will be invoked on failure

##### Data format

Success data will be a language object of the deleted language.

##### Example

`
window["MLKitTranslate"].deleteModel("es",
(data)=>console.log(data),
(err)=>console.log(err)
})

// prints {"code", "es", "displayName": "Spanish"}
`

or with Ionic Native

`
this.mlkitTranslate.deleteModel("es").then(lang=>{
console.log(langs);
})

// prints {"code", "es", "displayName": "Spanish"}
``

LICENSE

This plugin is licensed under the MIT License