Tłumaczenie tekstu za pomocą ML Kit na Androidzie

Za pomocą ML Kit możesz tłumaczyć tekst z jednego języka na inny. ML Kit umożliwia tłumaczenie z powyżej 50 języków.

Wypróbuj

Zanim zaczniesz

  1. W pliku build.gradle na poziomie projektu uwzględnij repozytorium Maven firmy Google w sekcjach buildscript i allprojects.
  2. Dodaj zależności do bibliotek ML Kit na Androida do pliku Gradle modułu na poziomie aplikacji, który zwykle jest app/build.gradle: 
    dependencies {
  // ...

  implementation 'com.google.mlkit:translate:17.0.3'
}

Tłumaczenie ciągu tekstowego

Aby przetłumaczyć ciąg znaków z jednego języka na inny:

  1. Utwórz obiekt Translator, konfigurując go z językiem źródłowym i docelowym:

    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);

    Jeśli nie znasz języka tekstu wejściowego, możesz użyć interfejsu Language Identification API, który podaje tag języka. Następnie za pomocą tagu TranslateLanguage przekonwertuj go na tag TranslateLanguage.fromLanguageTag().

    Nie przechowuj na urządzeniu zbyt wielu modeli językowych jednocześnie.

  2. Upewnij się, że wymagany model tłumaczenia został pobrany na urządzenie. Nie dzwoń do translate(), dopóki nie będziesz mieć pewności, że model jest dostępny.

    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.
            // ...
          }
        });

    Modele językowe zajmują około 30 MB, więc nie pobieraj ich bez potrzeby. Pobieraj je tylko przez Wi-Fi, chyba że użytkownik określił inaczej. Należy też usunąć niepotrzebne modele. Zobacz Zarządzanie modelami tłumaczeń.

  3. Po potwierdzeniu, że model został pobrany, prześlij ciąg tekstowy w języku źródłowym do funkcji 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.
            // ...
          }
        });

    Przetłumaczony tekst w skonfigurowanym języku docelowym jest przekazywany do listenera success.

  4. Upewnij się, że metoda close() jest wywoływana, gdy obiekt Translator nie będzie już używany.

    Jeśli używasz usługi tłumaczenia w Fragment lub AppCompatActivity, możesz łatwo wywołać metodę LifecycleOwner.getLifecycle() w Fragment lub AppCompatActivity, a potem wywołać metodę Lifecycle.addObserver. Na przykład:

    Kotlin

    val options = ...
val translator = Translation.getClient(options)
getLifecycle().addObserver(translator)

    Java

    TranslatorOptions options = ...
Translator translator = Translation.getClient(options);
getLifecycle().addObserver(translator);
... use translator ...

    Zakładamy, że kod znajduje się w klasie implementującej LifecycleOwner (np. Fragment lub AppCompatActivity).

Wyraźne zarządzanie modelami tłumaczeń

Gdy używasz interfejsu Translation API zgodnie z opisem powyżej, ML Kit automatycznie pobiera na urządzenie odpowiednie modele tłumaczenia w zależności od języka. Możesz też wyraźnie zarządzać modelami tłumaczenia, które chcesz mieć dostępne na urządzeniu, za pomocą interfejsu API do zarządzania modelami tłumaczenia w ML Kit. Może to być przydatne, jeśli chcesz pobrać modele z wyprzedzeniem lub usunąć z urządzenia niepotrzebne modele.

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