Text mit ML Kit auf Android übersetzen

Mit ML Kit können Sie Text zwischen Sprachen übersetzen. ML Kit kann in mehr als 50 Sprachen übersetzen.

Jetzt ausprobieren

• Beispiel-App ausprobieren, um ein Beispiel für die Verwendung dieser API zu sehen.

Hinweis

1. In die Datei build.gradle auf Projektebene muss das Maven-Repository von Google in die Abschnitte buildscript und allprojects aufgenommen werden.
2. Fügen Sie die Abhängigkeiten für die ML Kit Android-Bibliotheken der Gradle-Datei auf App-Ebene Ihres Moduls hinzu. Diese befindet sich in der Regel unter app/build.gradle:

   dependencies {
     // ...
   
     implementation 'com.google.mlkit:translate:17.0.3'
   }

Textstring übersetzen

So übersetzen Sie einen String zwischen zwei Sprachen:

1. 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 Ihnen ein Sprach-Tag zurückgibt. Konvertieren Sie das Tag dann mit TranslateLanguage.fromLanguageTag() in ein TranslateLanguage.

   Vermeiden Sie es, zu viele Sprachmodelle gleichzeitig auf dem Gerät zu speichern.

2. Achten Sie darauf, dass das erforderliche Übersetzungsmodell auf das Gerät heruntergeladen wurde. Rufen Sie translate() erst an, 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 und nur über WLAN, sofern der Nutzer nichts anderes angegeben hat. Sie sollten auch nicht benötigte Modelle löschen. Weitere Informationen finden Sie unter Übersetzungsmodelle explizit verwalten.

3. 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.

4. Achten Sie darauf, dass die Methode close() aufgerufen wird, wenn das Objekt Translator nicht mehr verwendet wird.

   Wenn Sie einen Translator in einem Fragment oder einer AppCompatActivity verwenden, können Sie dazu einfach LifecycleOwner.getLifecycle() für das Fragment oder die AppCompatActivity aufrufen 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 in 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 auf das Gerät herunter, wenn sie benötigt werden. Mit der API zur Verwaltung von Übersetzungsmodellen von ML Kit können Sie auch explizit die Übersetzungsmodelle verwalten, die auf dem Gerät verfügbar sein sollen. Das kann nützlich sein, wenn Sie Modelle im Voraus herunterladen oder nicht benötigte Modelle vom Gerät löschen möchten.

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.
    }

RemoteModelManager modelManager = RemoteModelManager.getInstance();

// Get translation models stored on the device.
modelManager.getDownloadedModels(TranslateRemoteModel.class)
    .addOnSuccessListener(new OnSuccessListener<Set>() {
        @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.
        }
    });