תרגום טקסט באמצעות ערכת ML ב-Android

אתם יכולים להשתמש ב-ML Kit כדי לתרגם טקסט בין שפות. נכון לעכשיו, ב-ML Kit יש תמיכה בתרגום בין 59 שפות.

לפני שמתחילים

  1. אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט Android.
  2. מוסיפים את יחסי התלות של ספריות ML Kit ל-Android לקובץ Gradle של המודול (ברמת האפליקציה) (בדרך כלל app/build.gradle): 
    apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'

dependencies {
  // ...

  implementation 'com.google.firebase:firebase-ml-natural-language:22.0.0'
  implementation 'com.google.firebase:firebase-ml-natural-language-translate-model:20.0.8'
}

תרגום מחרוזת טקסט

כדי לתרגם מחרוזת בין שתי שפות:

  1. יוצרים אובייקט FirebaseTranslator ומגדירים את שפות המקור והיעד:

    Java 

    // Create an English-German translator:
FirebaseTranslatorOptions options =
        new FirebaseTranslatorOptions.Builder()
                .setSourceLanguage(FirebaseTranslateLanguage.EN)
                .setTargetLanguage(FirebaseTranslateLanguage.DE)
                .build();
final FirebaseTranslator englishGermanTranslator =
        FirebaseNaturalLanguage.getInstance().getTranslator(options);

    Kotlin 

    // Create an English-German translator:
val options = FirebaseTranslatorOptions.Builder()
        .setSourceLanguage(FirebaseTranslateLanguage.EN)
        .setTargetLanguage(FirebaseTranslateLanguage.DE)
        .build()
val englishGermanTranslator = FirebaseNaturalLanguage.getInstance().getTranslator(options)

    אם אתם לא יודעים מהי שפת הטקסט להזנה, תוכלו להשתמש קודם ב-language identification API. (אבל חשוב לא לאחסן יותר מדי מודלים של שפות במכשיר בו-זמנית).

  2. מוודאים שהורדתם את מודל התרגום הנדרש למכשיר. אל תתקשרו למספר translate() עד שתדעו שהדגם זמין.

    Java 

    FirebaseModelDownloadConditions conditions = new FirebaseModelDownloadConditions.Builder()
    .requireWifi()
    .build();
englishGermanTranslator.downloadModelIfNeeded(conditions)
      .addOnSuccessListener(
          new OnSuccessListener<Void>() {
            @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.
              // ...
            }
          });

    Kotlin 

    englishGermanTranslator.downloadModelIfNeeded()
        .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.
            // ...
        }

    מודלים בסיסיים של שפה הם בגודל של כ-30MB, לכן אין להוריד אותם ללא צורך, ואפשר להוריד אותם רק באמצעות חיבור Wi-Fi, אלא אם המשתמש ציין אחרת. מומלץ גם למחוק מודלים שלא נחוצים. ניהול מפורש של מודלים של תרגום

  3. אחרי שמוודאים שהמודל הוריד, מעבירים מחרוזת טקסט בשפת המקור אל translate():

    Java 

    englishGermanTranslator.translate(text)
      .addOnSuccessListener(
          new OnSuccessListener<String>() {
            @Override
            public void onSuccess(@NonNull String translatedText) {
              // Translation successful.
            }
          })
      .addOnFailureListener(
          new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
              // Error.
              // ...
            }
          });

    Kotlin 

    englishGermanTranslator.translate(text)
        .addOnSuccessListener { translatedText ->
            // Translation successful.
        }
        .addOnFailureListener { exception ->
             // Error.
             // ...
        }

    הטקסט המתורגם, בשפת היעד שהגדרתם, מועבר למאזין להצלחה.

ניהול מפורש של מודלים של תרגום

כשמשתמשים ב-Translation API כפי שמתואר למעלה, ML Kit מורידים באופן אוטומטי למכשיר מודלים של תרגום ספציפיים לשפה לפי הצורך. אפשר גם לנהל באופן מפורש את מודלי התרגום שרוצים שיופיעו במכשיר באמצעות ה-API לניהול מודלים של תרגום ב-ML Kit. אפשר להשתמש באפשרות הזו כדי להוריד מודלים מראש או למחוק מודלים לא נחוצים מהמכשיר.

Java 

FirebaseModelManager modelManager = FirebaseModelManager.getInstance();

// Get translation models stored on the device.
modelManager.getDownloadedModels(FirebaseTranslateRemoteModel.class)
        .addOnSuccessListener(new OnSuccessListener<Set<FirebaseTranslateRemoteModel>>() {
            @Override
            public void onSuccess(Set<FirebaseTranslateRemoteModel> models) {
                // ...
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // Error.
            }
        });

// Delete the German model if it's on the device.
FirebaseTranslateRemoteModel deModel =
        new FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.DE).build();
modelManager.deleteDownloadedModel(deModel)
        .addOnSuccessListener(new OnSuccessListener<Void>() {
            @Override
            public void onSuccess(Void v) {
                // Model deleted.
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // Error.
            }
        });

// Download the French model.
FirebaseTranslateRemoteModel frModel =
        new FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.FR).build();
FirebaseModelDownloadConditions conditions = new FirebaseModelDownloadConditions.Builder()
        .requireWifi()
        .build();
modelManager.download(frModel, conditions)
        .addOnSuccessListener(new OnSuccessListener<Void>() {
            @Override
            public void onSuccess(Void v) {
                // Model downloaded.
            }
        })
        .addOnFailureListener(new OnFailureListener() {
            @Override
            public void onFailure(@NonNull Exception e) {
                // Error.
            }
        });

Kotlin 

val modelManager = FirebaseModelManager.getInstance()

// Get translation models stored on the device.
modelManager.getDownloadedModels(FirebaseTranslateRemoteModel::class.java)
    .addOnSuccessListener { models ->
        // ...
    }
    .addOnFailureListener {
        // Error.
    }

// Delete the German model if it's on the device.
val deModel = FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.DE).build()
modelManager.deleteDownloadedModel(deModel)
    .addOnSuccessListener {
        // Model deleted.
    }
    .addOnFailureListener {
        // Error.
    }

// Download the French model.
val frModel = FirebaseTranslateRemoteModel.Builder(FirebaseTranslateLanguage.FR).build()
val conditions = FirebaseModelDownloadConditions.Builder()
    .requireWifi()
    .build()
modelManager.download(frModel, conditions)
    .addOnSuccessListener {
        // Model downloaded.
    }
    .addOnFailureListener {
        // Error.
    }