Bu sayfa, Cloud Translation API ile çevrilmiştir.

iOS'te Makine Öğrenimi Kiti ile metin çevirme

Diller arasında metin çevirisi yapmak için Makine Öğrenimi Kiti'ni kullanabilirsiniz. Makine Öğrenimi Kiti birden fazla 50 dil.

Deneyin

Örnek uygulamayı kullanarak bu API'nin örnek kullanımını inceleyin.

Başlamadan önce

Aşağıdaki ML Kit kapsüllerini Podfile'ınıza ekleyin:
```
pod 'GoogleMLKit/Translate', '3.2.0'
```
.
Projenizin kapsüllerini yükledikten veya güncelledikten sonra .xcworkspace ML Kit, Xcode 12.4 veya sonraki sürümlerde desteklenir.

Metin dizesini çevirme

Bir dizeyi iki dil arasında çevirmek için:

Kaynak ve hedef ile yapılandırarak bir Translator nesnesi oluşturun diller:

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];

Giriş metninin dilini bilmiyorsanız Dil Identity API bir dil etiketi sağlar. Daha sonra, dil etiketini makine öğrenimi kiti sıralamasıdır. Kod, kullandığınız dile bağlıdır:

Swift: TranslateLanguage kazanmak için TranslateLanguage.fromLanguageTag() numaralı telefonu arayın
Hedef C: MLKTranslateLanguage kazanmak için MLKTranslateLanguageForLanguageTag() numaralı telefonu arayın

Cihazda aynı anda çok fazla dil modelini bulundurmaktan kaçının.

Gerekli çeviri modelinin cihaza indirildiğinden emin olun. Modelin kullanılabilir olduğunu öğrenene kadar translate(_:completion:) adlı iş ortağını aramayın.

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.
}];

Dil modelleri yaklaşık 30 MB boyutunda olduğundan bunları gereksiz yere indirmeyin ve kullanıcı aksini belirtmedikçe yalnızca kablosuz ağ üzerinden indirmelidir. Siz artık ihtiyaç duyulmayan modelleri silmesi gerekir. Çeviri modellerini açıkça yönetme bölümüne bakın.

Modelin indirildiğini onayladıktan sonra kaynak dili translate(_:completion:) olarak ayarlayın:

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.
      }];

Makine Öğrenimi Kiti, metni yapılandırdığınız hedef dile çevirir çevrilen metni tamamlama işleyiciye iletir.

Çevirmen yaşam döngüleri ARC (otomatik referans sayımı) tarafından kontrol edilir. Bu, iOS'e yönelik geliştirme için önerilen kuraldır. Geliştiriciler, tüm güçlü referanslar kaldırıldıktan sonra teslim edilecek Çevirmen'i seçin.

Çevirmenler belleğe yüklendiklerinde 30 MB ila 150 MB kaplayabilir. Geliştiriciler şunu yapmalıdır: Eşzamanlı öğe oluştururken cihazın/uygulamanın bellek bütçesini göz önünde bulundurun çevirmen ve cihazda çok fazla dil modeli bulundurmaktan kaçının sahip olabilirsiniz.

Çeviri modellerini açık bir şekilde yönetin

Çeviri API'sini yukarıda açıklandığı şekilde kullandığınızda ML Kit otomatik olarak dile özgü çeviri modellerini cihaza indirir. Siz mevcut olmasını istediğiniz çeviri modellerini doğrudan yönetebilirsiniz. makine öğrenimi kiti çeviri modeli yönetim API'sini Bu özellik, modelleri önceden indirmek veya gereksiz modelleri silmek istiyorsanız kullanışlıdır kaldırmamız gerekir.

Cihazda depolanan çeviri modellerini almak için:

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet *localModels =
    [MLKModelManager modelManager].downloadedTranslateModels;

Bir modeli silmek için:

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.

Bir model indirmek için:

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 ile indirme durumunu öğrenmek istiyorsanız kaydolun mlkitModelDownloadDidSucceed ve için gözlemciler mlkitModelDownloadDidFail. self için zayıf bir referans kullandığınızdan emin olun İndirmeler biraz zaman alabildiğinden ve indirme işlemi nesne, indirme işlemi tamamlandığında serbest bırakılabilir. Örneğin:

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 ile indirme durumunu öğrenmek istiyorsanız kaydolun MLKModelDownloadDidSucceedNotification ve için gözlemciler MLKModelDownloadDidFailNotification. İndirme işlemi biraz zaman alabileceğinden gözlemci blokunda self ve kaynak nesne, indirme işlemi tamamlandığında serbest bırakılabilir.

__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];
 }];