דף זה תורגם על ידי Cloud Translation API.

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

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

אני רוצה לנסות

שחקו עם האפליקציה לדוגמה כדי לראות דוגמה לשימוש ב-API הזה.

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

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

איך מתרגמים מחרוזת טקסט

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

יוצרים אובייקט 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];
```
אם לא יודעים מהי השפה של טקסט הקלט, אפשר להשתמש ב-Language Identification API, שמספק תג שפה. לאחר מכן ממירים את תג השפה ל-ML Kit enum. הקוד תלוי בשפה שבה משתמשים:
- Swift: אפשר להתקשר אל TranslateLanguage.fromLanguageTag() כדי לקבל TranslateLanguage
- מטרה ג': התקשרו אל MLKTranslateLanguageForLanguageTag() כדי לקבל MLKTranslateLanguage
הימנע משמירת מודלים רבים מדי של שפה במכשיר בו-זמנית.

מוודאים שמודל התרגום הנדרש הורד למכשיר. מומלץ לא להתקשר אל 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, אלא אם המשתמש ציין אחרת. כדאי למחוק מודלים שכבר אין בהם צורך. אפשר לקרוא מידע נוסף במאמר ניהול ספציפי של מודלים של תרגום.

אחרי שמוודאים שהמודל הורד, מעבירים מחרוזת טקסט בשפת המקור אל 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.
      }];

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

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

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

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

כשמשתמשים ב-Translate API כפי שמתואר למעלה, המערכת של ML Kit מורידה באופן אוטומטי מודלים של תרגום ספציפיים לשפה, לפי הצורך. אפשר גם לנהל באופן מפורש את המודלים של התרגום שרוצים שיהיו זמינים במכשיר באמצעות ממשק ה-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, צריך לרשום את ה-observers ל-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, צריך לרשום את ה-observers ל-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];
 }];