Как переводить текст с помощью ML Kit на Android

С помощью ML Kit можно переводить текст с одного языка на другой. ML Kit поддерживает перевод более чем на 50 языков.

Попробовать

Подготовка

  1. В файле build.gradle на уровне проекта убедитесь, что репозиторий Maven от Google указан в разделах buildscript и allprojects.
  2. Добавьте зависимости для библиотек ML Kit для Android в файл Gradle на уровне приложения, который обычно называется app/build.gradle: 
    dependencies {
  // ...

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

Как перевести строку текста

Чтобы перевести строку с одного языка на другой:

  1. Создайте объект Translator, указав исходный и целевой языки:

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

    Если вы не знаете язык входного текста, вы можете использовать Language Identification API, который предоставляет вам языковой тег. Затем преобразуйте тег в TranslateLanguage с помощью TranslateLanguage.fromLanguageTag().

    Не храните на устройстве слишком много языковых моделей одновременно.

  2. Убедитесь, что на устройство скачана нужная модель перевода. Не вызывайте функцию translate(), пока не убедитесь, что модель доступна.

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

    Размер языковых моделей составляет около 30 МБ, поэтому не скачивайте их без необходимости и используйте для этого только Wi-Fi, если пользователь не указал иное. Также рекомендуется удалить ненужные модели. Подробнее о том, как управлять моделями перевода…

  3. После того как вы убедитесь, что модель скачана, передайте строку текста на исходном языке в функцию 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.
            // ...
          }
        });

    Переведенный текст на языке перевода, который вы настроили, передается прослушивателю успешного выполнения.

  4. Убедитесь, что метод close() вызывается, когда объект Translator больше не используется.

    Если вы используете переводчик во фрагменте или AppCompatActivity, то можете вызвать LifecycleOwner.getLifecycle() во фрагменте или AppCompatActivity, а затем вызвать Lifecycle.addObserver. Пример:

    Kotlin

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

    Java

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

    Обратите внимание, что код должен находиться в классе, который реализует LifecycleOwner (например, Fragment или AppCompatActivity).

Как управлять моделями перевода

При использовании API для перевода, как описано выше, ML Kit автоматически скачивает на устройство языковые модели перевода по мере необходимости. Вы также можете явно управлять моделями перевода, доступными на устройстве, с помощью API управления моделями перевода ML Kit. Это может быть полезно, если вы хотите заранее скачать модели или удалить ненужные с устройства.

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