Mit ML Kit können Sie Text zwischen Sprachen übersetzen. ML Kit kann zwischen mehr als 50 Sprachen übersetzen.
Ausprobieren
- Probieren Sie die Beispiel-App aus, um ein Beispiel für die Verwendung dieser API zu sehen.
Hinweis
- Fügen Sie in der Datei
build.gradle
auf Projektebene in den Abschnittenbuildscript
undallprojects
das Maven-Repository von Google ein. - Fügen Sie der Gradle-Datei des Moduls auf App-Ebene die Abhängigkeiten für die ML Kit-Android-Bibliotheken hinzu. Diese ist in der Regel
app/build.gradle
:dependencies { // ... implementation 'com.google.mlkit:translate:17.0.2' }
Textfolge übersetzen
So übersetzen Sie einen String zwischen zwei Sprachen:
Erstellen Sie ein
Translator
-Objekt und konfigurieren Sie es mit den Quell- und Zielsprachen:Kotlin
// Create an English-German translator: val options = TranslatorOptions.Builder() .setSourceLanguage(TranslateLanguage.ENGLISH) .setTargetLanguage(TranslateLanguage.GERMAN) .build() val englishGermanTranslator = Translation.getClient(options)
Java
// Create an English-German translator: TranslatorOptions options = new TranslatorOptions.Builder() .setSourceLanguage(TranslateLanguage.ENGLISH) .setTargetLanguage(TranslateLanguage.GERMAN) .build(); final Translator englishGermanTranslator = Translation.getClient(options);
Wenn Sie die Sprache des Eingabetexts nicht kennen, können Sie die Language Identification API verwenden, die ein Sprach-Tag zur Verfügung stellt. Konvertieren Sie dann das Tag mithilfe von
TranslateLanguage.fromLanguageTag()
in einTranslateLanguage
-Tag.Vermeiden Sie es, zu viele Sprachmodelle gleichzeitig auf dem Gerät zu speichern.
Prüfen Sie, ob das erforderliche Übersetzungsmodell auf das Gerät heruntergeladen wurde. Rufen Sie
translate()
erst dann auf, wenn Sie wissen, dass das Modell verfügbar ist.Kotlin
var conditions = DownloadConditions.Builder() .requireWifi() .build() englishGermanTranslator.downloadModelIfNeeded(conditions) .addOnSuccessListener { // Model downloaded successfully. Okay to start translating. // (Set a flag, unhide the translation UI, etc.) } .addOnFailureListener { exception -> // Model couldn’t be downloaded or other internal error. // ... }
Java
DownloadConditions conditions = new DownloadConditions.Builder() .requireWifi() .build(); englishGermanTranslator.downloadModelIfNeeded(conditions) .addOnSuccessListener( new OnSuccessListener
() { @Override public void onSuccess(Void v) { // Model downloaded successfully. Okay to start translating. // (Set a flag, unhide the translation UI, etc.) } }) .addOnFailureListener( new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Model couldn’t be downloaded or other internal error. // ... } }); Sprachmodelle sind etwa 30 MB groß. Laden Sie sie also nicht unnötig herunter, sondern laden Sie sie nur über WLAN herunter, sofern der Nutzer nichts anderes angegeben hat. Außerdem sollten Sie nicht benötigte Modelle löschen. Weitere Informationen finden Sie unter Übersetzungsmodelle explizit verwalten.
Nachdem Sie bestätigt haben, dass das Modell heruntergeladen wurde, übergeben Sie einen Textstring in der Ausgangssprache an
translate()
:Kotlin
englishGermanTranslator.translate(text) .addOnSuccessListener { translatedText -> // Translation successful. } .addOnFailureListener { exception -> // Error. // ... }
Java
englishGermanTranslator.translate(text) .addOnSuccessListener( new OnSuccessListener
() { @Override public void onSuccess(@NonNull String translatedText) { // Translation successful. } }) .addOnFailureListener( new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Error. // ... } }); Der übersetzte Text in der von Ihnen konfigurierten Zielsprache wird an den Erfolgs-Listener übergeben.
Die Methode
close()
muss aufgerufen werden, wenn dasTranslator
-Objekt nicht mehr verwendet wird.Wenn Sie einen Translator in einem Fragment oder in einer AppCompatActivity verwenden, können Sie dazu einfach LifecycleOwner.getLifecycle() für das Fragment oder die AppCompatActivity und dann Lifecycle.addObserver aufrufen. Beispiel:
Kotlin
val options = ... val translator = Translation.getClient(options) getLifecycle().addObserver(translator)
Java
TranslatorOptions options = ... Translator translator = Translation.getClient(options); getLifecycle().addObserver(translator); ... use translator ...
Dabei wird davon ausgegangen, dass sich der Code innerhalb einer Klasse befindet, die LifecycleOwner implementiert (z.B. ein Fragment oder eine AppCompatActivity).
Übersetzungsmodelle explizit verwalten
Wenn Sie die Translation API wie oben beschrieben verwenden, lädt ML Kit automatisch sprachspezifische Übersetzungsmodelle nach Bedarf auf das Gerät herunter. Sie können die Übersetzungsmodelle, die auf dem Gerät verfügbar sein sollen, auch explizit verwalten, indem Sie die Translation Model Management API von ML Kit verwenden. Das kann nützlich sein, wenn du Modelle vorab herunterladen oder nicht benötigte Modelle vom Gerät löschen möchtest.
Kotlin
val modelManager = RemoteModelManager.getInstance() // Get translation models stored on the device. modelManager.getDownloadedModels(TranslateRemoteModel::class.java) .addOnSuccessListener { models -> // ... } .addOnFailureListener { // Error. } // Delete the German model if it's on the device. val germanModel = TranslateRemoteModel.Builder(TranslateLanguage.GERMAN).build() modelManager.deleteDownloadedModel(germanModel) .addOnSuccessListener { // Model deleted. } .addOnFailureListener { // Error. } // Download the French model. val frenchModel = TranslateRemoteModel.Builder(TranslateLanguage.FRENCH).build() val conditions = DownloadConditions.Builder() .requireWifi() .build() modelManager.download(frenchModel, conditions) .addOnSuccessListener { // Model downloaded. } .addOnFailureListener { // Error. }
Java
RemoteModelManager modelManager = RemoteModelManager.getInstance(); // Get translation models stored on the device. modelManager.getDownloadedModels(TranslateRemoteModel.class) .addOnSuccessListener(new OnSuccessListener>() { @Override public void onSuccess(Set models) { // ... } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Error. } }); // Delete the German model if it's on the device. TranslateRemoteModel germanModel = new TranslateRemoteModel.Builder(TranslateLanguage.GERMAN).build(); modelManager.deleteDownloadedModel(germanModel) .addOnSuccessListener(new OnSuccessListener () { @Override public void onSuccess(Void v) { // Model deleted. } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Error. } }); // Download the French model. TranslateRemoteModel frenchModel = new TranslateRemoteModel.Builder(TranslateLanguage.FRENCH).build(); DownloadConditions conditions = new DownloadConditions.Builder() .requireWifi() .build(); modelManager.download(frenchModel, conditions) .addOnSuccessListener(new OnSuccessListener () { @Override public void onSuccess(Void v) { // Model downloaded. } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { // Error. } });