אתם יכולים להשתמש ב-ML Kit כדי לתרגם טקסט בין שפות. בעזרת ML Kit תוכל לתרגם בין יותר מ-50 שפות.
אני רוצה לנסות
- אפשר לנסות את האפליקציה לדוגמה כדי לראות דוגמה לשימוש ב-API הזה.
לפני שמתחילים
- בקובץ
build.gradle
ברמת הפרויקט, חשוב לכלול את מאגר Maven של Google בקטעbuildscript
וגם בקטעallprojects
. - מוסיפים את יחסי התלות של ספריות ML Kit ל-Android לקובץ ההדרגתיות של המודול ברמת האפליקציה, שהוא בדרך כלל
app/build.gradle
:dependencies { // ... implementation 'com.google.mlkit:translate:17.0.2' }
תרגום של מחרוזת טקסט
כדי לתרגם מחרוזת בין שתי שפות:
יוצרים אובייקט
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()
.נמנעים משמירת מודלים רבים מדי של שפה במכשיר בו-זמנית.
מוודאים שמודל התרגום הנדרש הורד למכשיר. אין להתקשר אל
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. // ... } }); מודלים של שפה הם בנפח של כ-30MB, לכן אין להוריד אותם שלא לצורך. יש להוריד אותם רק באמצעות Wi-Fi, אלא אם המשתמש ציין אחרת. כמו כן, צריך למחוק מודלים לא נחוצים. למידע נוסף, אפשר לעיין בקטע ניהול מודלים של תרגום מפורשות.
אחרי שמוודאים שהמודל הורד, מעבירים מחרוזת טקסט בשפת המקור אל
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. // ... } }); הטקסט המתורגם בשפת היעד שהגדרתם מועבר אל ה-listener.
מוודאים שמתבצעת קריאה ל-method
close()
כשמפסיקים להשתמש באובייקטTranslator
.אם אתם משתמשים בתרגום ב-Fragment או ב-AppCompatActivity, אחת הדרכים הפשוטות לעשות זאת היא לקרוא ל-LifecycleOwner.getLifecycle() ב-Fragment או ב-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>() { @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. } });