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

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

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

  1. אם עדיין לא הוספתם את Firebase לאפליקציה, צריך לבצע את הפעולות הבאות במדריך לתחילת העבודה.
  2. מוסיפים את ספריות ML Kit ל-Podfile: 
    pod 'Firebase/MLNLTranslate', '6.25.0'
    אחרי שמתקינים או מעדכנים את קבוצות ה-Pod של הפרויקט, חשוב לפתוח את ה-Xcode באמצעות ה-.xcworkspace שלו.
  3. באפליקציה, מייבאים את Firebase:

    Swift

    import Firebase

    Objective-C

    @import Firebase;

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

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

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

    Swift

    // Create an English-German translator:
let options = TranslatorOptions(sourceLanguage: .en, targetLanguage: .de)
let englishGermanTranslator = NaturalLanguage.naturalLanguage().translator(options: options)

    Objective-C

    // Create an English-German translator:
FIRTranslatorOptions *options =
    [[FIRTranslatorOptions alloc] initWithSourceLanguage:FIRTranslateLanguageEN
                                          targetLanguage:FIRTranslateLanguageDE];
FIRTranslator *englishGermanTranslator =
    [[FIRNaturalLanguage naturalLanguage] translatorWithOptions:options];

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

  2. חשוב לוודא שהורדתם למכשיר את מודל התרגום הנדרש. אין להתקשר אל translate(_:completion:) לפני שידוע לך שהמודל זמין.

    Swift

    let conditions = ModelDownloadConditions(
    allowsCellularAccess: false,
    allowsBackgroundDownloading: true
)
englishGermanTranslator.downloadModelIfNeeded(with: conditions) { error in
    guard error == nil else { return }

    // Model downloaded successfully. Okay to start translating.
}

    Objective-C

    FIRModelDownloadConditions *conditions =
    [[FIRModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
[englishGermanTranslator downloadModelIfNeededWithConditions:conditions
                                                  completion:^(NSError *_Nullable error) {
  if (error != nil) {
    return;
  }
  // Model downloaded successfully. Okay to start translating.
}];

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

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

    Swift

    englishGermanTranslator.translate(text) { translatedText, error in
    guard error == nil, let translatedText = translatedText else { return }

    // Translation succeeded.
}

    Objective-C

    [englishGermanTranslator translateText:text
                            completion:^(NSString *_Nullable translatedText,
                                         NSError *_Nullable error) {
  if (error != nil || translatedText == nil) {
    return;
  }

  // Translation succeeded.
}];

    ערכת למידת מכונה מתרגמת את הטקסט לשפת היעד שהגדרתם מעביר את הטקסט המתורגם ל-handler של ההשלמה.

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

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

כדי לשמור את המודלים לתרגום במכשיר:

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet<FIRTranslateRemoteModel *> *localModels =
    [FIRModelManager modelManager].downloadedTranslateModels;

כדי למחוק מודל:

Swift

// Delete the German model if it's on the device.
let deModel = TranslateRemoteModel.translateRemoteModel(language: .de)
ModelManager.modelManager().deleteDownloadedModel(deModel) { error in
    guard error == nil else { return }
    // Model deleted.
}

Objective-C

// Delete the German model if it's on the device.
FIRTranslateRemoteModel *deModel =
    [FIRTranslateRemoteModel translateRemoteModelWithLanguage:FIRTranslateLanguageDE];
[[FIRModelManager modelManager] deleteDownloadedModel:deModel
                                           completion:^(NSError * _Nullable error) {
                                               if (error != nil) {
                                                   return;
                                               }
                                               // Model deleted.
                                           }];

כדי להוריד מודל:

Swift

// Download the French model.
let frModel = TranslateRemoteModel.translateRemoteModel(language: .fr)

// Keep a reference to the download progress so you can check that the model
// is available before you use it.
progress = ModelManager.modelManager().download(
    frModel,
    conditions: ModelDownloadConditions(
        allowsCellularAccess: false,
        allowsBackgroundDownloading: true
    )
)

כדי לקבל את סטטוס ההורדה של NotificationCenter, צריך להירשם התצפיתנים של firebaseMLModelDownloadDidSucceed וגם firebaseMLModelDownloadDidFail. חשוב להשתמש בהפניה חלשה ל-self בבלוק הצופה, כי ההורדות עשויות להימשך זמן מה, והאובייקט המקור יכול להשתחרר עד שההורדה תסתיים. לדוגמה:

NotificationCenter.default.addObserver(
    forName: .firebaseMLModelDownloadDidSucceed,
    object: nil,
    queue: nil
) { [weak self] notification in
    guard let strongSelf = self,
        let userInfo = notification.userInfo,
        let model = userInfo[ModelDownloadUserInfoKey.remoteModel.rawValue]
            as? TranslateRemoteModel,
        model == frModel
        else { return }
    // The model was downloaded and is available on the device
}

NotificationCenter.default.addObserver(
    forName: .firebaseMLModelDownloadDidFail,
    object: nil,
    queue: nil
) { [weak self] notification in
    guard let strongSelf = self,
        let userInfo = notification.userInfo,
        let model = userInfo[ModelDownloadUserInfoKey.remoteModel.rawValue]
            as? TranslateRemoteModel
        else { return }
    let error = userInfo[ModelDownloadUserInfoKey.error.rawValue]
    // ...
}

Objective-C

// Download the French model.
FIRModelDownloadConditions *conditions =
    [[FIRModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
FIRTranslateRemoteModel *frModel =
    [FIRTranslateRemoteModel translateRemoteModelWithLanguage:FIRTranslateLanguageFR];

// Keep a reference to the download progress so you can check that the model
// is available before you use it.
self.downloadProgress = [[FIRModelManager modelManager] downloadModel:frModel
                                                           conditions:conditions];

כדי לקבל את סטטוס ההורדה של NSNotificationCenter, צריך להירשם התצפיתנים של FIRModelDownloadDidSucceedNotification וגם FIRModelDownloadDidFailNotification. הקפידו להשתמש בהפניה חלשה self בבלוק הצופים, מכיוון שההורדות עשויות להימשך זמן מה, ניתן לשחרר את אובייקט המקור עד לסיום ההורדה.

__block MyViewController *weakSelf = self;

[NSNotificationCenter.defaultCenter
 addObserverForName:FIRModelDownloadDidSucceedNotification
 object:nil
 queue:nil
 usingBlock:^(NSNotification * _Nonnull note) {
     if (weakSelf == nil | note.userInfo == nil) {
         return;
     }

     FIRTranslateRemoteModel *model = note.userInfo[FIRModelDownloadUserInfoKeyRemoteModel];
     if ([model isKindOfClass:[FIRTranslateRemoteModel class]]
         && model == frModel) {
         // The model was downloaded and is available on the device
     }
 }];

[NSNotificationCenter.defaultCenter
 addObserverForName:FIRModelDownloadDidFailNotification
 object:nil
 queue:nil
 usingBlock:^(NSNotification * _Nonnull note) {
     if (weakSelf == nil | note.userInfo == nil) {
         return;
     }

     NSError *error = note.userInfo[FIRModelDownloadUserInfoKeyError];
 }];