Traduzir texto com o Kit de ML no Android

É possível usar o Kit de ML para traduzir textos entre idiomas. O Kit de ML pode fazer a tradução entre mais de 50 idiomas.

Faça um teste

• Teste o app de exemplo para conferir um exemplo de uso dessa API.

Antes de começar

1. No arquivo build.gradle no nível do projeto, inclua o repositório Maven do Google nas seções buildscript e allprojects.
2. Adicione as dependências das bibliotecas do Android do Kit de ML ao arquivo Gradle no nível do app do módulo, que geralmente é app/build.gradle:

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

Traduzir uma string de texto

Para traduzir uma string entre dois idiomas:

1. Crie um objeto Translator e configure-o com os idiomas de origem e de destino:

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

   Se você não souber o idioma do texto de entrada, use a API de identificação de idioma, que oferece uma tag de idioma. Em seguida, converta a tag em um TranslateLanguage usando TranslateLanguage.fromLanguageTag().

   Evite manter muitos modelos de idioma no dispositivo ao mesmo tempo.

2. Verifique se o modelo de tradução necessário foi salvo no dispositivo. Não chame translate() até verificar se o modelo está disponível.

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

   Os modelos de idioma têm cerca de 30 MB, portanto, faça o download deles apenas quando necessário e usando Wi-Fi, a menos que o usuário tenha especificado o contrário. Além disso, exclua modelos desnecessários. Consulte Gerenciar explicitamente modelos de tradução.

3. Depois de confirmar que o modelo foi salvo, transmita uma string de texto no idioma de origem para 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.
               // ...
             }
           });

   O texto traduzido, no idioma de destino que você configurou, é transmitido para o listener de êxito.

4. O método close() é chamado quando o objeto Translator não será mais usado.

   Se você estiver usando um tradutor em um fragmento ou AppCompatActivity, uma maneira fácil de fazer isso é chamar LifecycleOwner.getLifecycle() no fragmento ou AppCompatActivity e, em seguida, chamar Lifecycle.addObserver. Exemplo:

   Kotlin

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

   Java

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

   Isso pressupõe que o código esteja dentro de uma classe que implementa LifecycleOwner (por exemplo, um fragmento ou AppCompatActivity).

Gerenciar explicitamente modelos de tradução

Quando a API de tradução é usada conforme descrito acima, o Kit de ML faz o download automático de modelos de tradução específicos do idioma para o dispositivo, conforme necessário. Também é possível gerenciar explicitamente os modelos de tradução que você quer disponibilizar no dispositivo usando a API de gerenciamento de modelos de tradução do Kit de ML. Isso pode ser útil se você quiser fazer o download de modelos antecipadamente ou excluir modelos desnecessários do dispositivo.

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