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

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

רוצה לנסות?

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

  1. כוללים ב-Podfile את רצפי ה-ML Kit הבאים:
    pod 'GoogleMLKit/Translate', '3.2.0'
    
  2. אחרי שמתקינים או מעדכנים את קבוצות ה-Pod של הפרויקט, פותחים את פרויקט Xcode באמצעות .xcworkspace יש תמיכה ב-ML Kit ב-Xcode מגרסה 12.4 ואילך.

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

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

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

    Swift

        // Create an English-German translator:
        let options = TranslatorOptions(sourceLanguage: .english, targetLanguage: .german)
        let englishGermanTranslator = Translator.translator(options: options)

    Objective-C

        // Create an English-German translator:
        MLKTranslatorOptions *options =
            [[MLKTranslatorOptions alloc] initWithSourceLanguage:MLKTranslateLanguageEnglish
                                                  targetLanguage:MLKTranslateLanguageGerman];
        MLKTranslator *englishGermanTranslator =
            [MLKTranslator translatorwithOptions:options];

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

    לא מומלץ לשמור יותר מדי מודלים של שפה במכשיר בו-זמנית.

  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

    MLKModelDownloadConditions *conditions =
        [[MLKModelDownloadConditions 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 של ההשלמה.

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

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

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

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

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

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet *localModels =
    [MLKModelManager modelManager].downloadedTranslateModels;

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

Swift

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

Objective-C

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

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

Swift

// Download the French model.
let frenchModel = TranslateRemoteModel.translateRemoteModel(language: .french)

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

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

NotificationCenter.default.addObserver(
    forName: .mlkitModelDownloadDidSucceed,
    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 == frenchModel
        else { return }
    // The model was downloaded and is available on the device
}

NotificationCenter.default.addObserver(
    forName: .mlkitModelDownloadDidFail,
    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.
MLKModelDownloadConditions *conditions =
    [[MLKModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
MLKTranslateRemoteModel *frenchModel =
    [MLKTranslateRemoteModel translateRemoteModelWithLanguage:MLKTranslateLanguageFrench];

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

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

__block MyViewController *weakSelf = self;

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

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

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

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