Menerjemahkan teks dengan ML Kit di Android

Anda dapat menggunakan ML Kit untuk menerjemahkan teks antarbahasa. ML Kit dapat menerjemahkan lebih dari 50 bahasa.

Cobalah

Sebelum memulai

  1. Dalam file build.gradle level project, pastikan Anda memasukkan repositori Maven Google di bagian buildscript dan allprojects.
  2. Tambahkan dependensi untuk library Android ML Kit ke file gradle level aplikasi modul Anda, biasanya app/build.gradle: 
    dependencies {
  // ...

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

Menerjemahkan string teks

Untuk menerjemahkan string antara dua bahasa:

  1. Buat objek Translator, lalu konfigurasikan dengan bahasa sumber dan target:

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

    Jika tidak tahu bahasa teks input, Anda dapat menggunakan Language Identification API yang memberi Anda tag bahasa. Lalu, konversikan tag menjadi TranslateLanguage menggunakan TranslateLanguage.fromLanguageTag().

    Hindari menyimpan terlalu banyak model bahasa di perangkat sekaligus.

  2. Pastikan model terjemahan yang diperlukan telah didownload ke perangkat. Jangan panggil translate() sampai Anda mengetahui bahwa model tersebut tersedia.

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

    Ukuran model bahasa sekitar 30 MB, jadi jangan mendownloadnya jika tidak perlu dan hanya download menggunakan Wi-Fi kecuali jika pengguna telah menentukan sebaliknya. Anda juga harus menghapus model yang tidak diperlukan. Lihat Mengelola model terjemahan secara eksplisit.

  3. Setelah Anda mengonfirmasi bahwa model telah didownload, teruskan string teks dalam bahasa sumber ke 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.
            // ...
          }
        });

    Teks yang diterjemahkan, dalam bahasa target yang Anda konfigurasi, akan diteruskan ke pemroses peristiwa sukses.

  4. Pastikan metode close() dipanggil saat objek Translator tidak akan digunakan lagi.

    Jika Anda menggunakan Penerjemah di Fragment atau AppCompatActivity, satu cara yang mudah untuk melakukannya adalah memanggil LifecycleOwner.getLifecycle() pada Fragment atau AppCompatActivity, lalu memanggil Lifecycle.addObserver. Contoh:

    Kotlin

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

    Java

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

    Perlu diperhatikan bahwa langkah ini mengasumsikan bahwa kode berada di dalam class yang mengimplementasikan LifecycleOwner (misalnya, Fragment atau AppCompatActivity).

Mengelola model terjemahan secara eksplisit

Ketika Anda menggunakan Translation API seperti yang dijelaskan di atas, ML Kit akan otomatis mendownload model terjemahan bahasa tertentu ke perangkat sesuai kebutuhan. Anda juga dapat secara eksplisit mengelola model terjemahan yang Anda inginkan tersedia di perangkat menggunakan API pengelolaan model terjemahan dari ML Kit. Hal ini dapat berguna jika Anda ingin mendownload model terlebih dahulu, atau menghapus model yang tidak diperlukan dari perangkat.

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