iOS'te ML Kit ile metin çevirme

Diller arasında metin çevirmek için ML Kit'i kullanabilirsiniz. ML Kit 50'den fazla dil arasında çeviri yapabilir.

Deneyin

Başlamadan önce

  1. Aşağıdaki ML Kit kapsüllerini Podfile dosyanıza ekleyin:
    pod 'GoogleMLKit/Translate', '3.2.0'
    
  2. Projenizin Kapsüllerini yükledikten veya güncelledikten sonra, .xcworkspace kodunu kullanarak Xcode projenizi açın. ML Kit, Xcode'un 12.4 veya sonraki sürümlerinde desteklenir.

Bir metin dizesini çevirme

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

  1. Kaynak ve hedef dillerle yapılandırarak bir Translator nesnesi oluşturun:

    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 size dil etiketi sağlayan Dil Tanımlama API'sini kullanabilirsiniz. Ardından dil etiketini bir ML Kit enum biçimine dönüştürün. Kod, kullandığınız dile bağlıdır:

    Cihazda aynı anda çok fazla dil modeli kullanmaktan kaçının.

  2. Gerekli çeviri modelinin cihaza indirildiğinden emin olun. Modelin kullanılabilir olduğunu öğrenene kadar translate(_:completion:) numarası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'tır. Bu nedenle gereksiz yere indirmeyin ve kullanıcı aksini belirtmediği sürece yalnızca kablosuz bağlantı kullanarak indirin. Artık ihtiyaç duyulmayan modelleri silmeniz gerekir. Çeviri modellerini açıkça yönetme başlıklı makaleyi inceleyin.

  3. Modelin indirildiğini onayladıktan sonra kaynak dilde bir metin dizesini translate(_:completion:) adresine iletin:

    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, metni yapılandırdığınız hedef dile çevirir ve çevrilmiş metni tamamlama işleyicisine iletir.

Çevirmen yaşam döngüleri, iOS geliştirmesi için önerilen kural olan ARC (otomatik referans sayma) tarafından kontrol edilir. Geliştiriciler, tüm güçlü referanslar kaldırıldıktan sonra Çevirmenin yeniden yerleştirilmesini bekleyebilir.

Çevirmenler bellekte yüklendiğinde 30 MB-150 MB arasında yer kaplar. Geliştiriciler, eşzamanlı çevirmen örnekleri oluştururken cihazın/uygulamanın bellek bütçesini göz önünde bulundurmalı ve aynı anda cihazda çok fazla dil modeli tutmamalıdır.

Çeviri modellerini açıkça yönetin

Yukarıda açıklandığı şekilde çeviri API'sini kullandığınızda ML Kit, dile göre çeviri modellerini cihaza otomatik olarak indirir. Cihazda kullanılmasını istediğiniz çeviri modellerini ML Kit'in çeviri modeli yönetimi API'sini kullanarak açıkça da yönetebilirsiniz. Bu, modelleri önceden indirmek veya gereksiz modelleri cihazdan silmek isterseniz yararlı olabilir.

Çeviri modellerinin cihazda depolanmasını sağlamak 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.

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 almak istiyorsanız mlkitModelDownloadDidSucceed ve mlkitModelDownloadDidFail için gözlemcileri kaydedin. İndirme işlemleri uzun sürebileceğinden ve indirme işlemi tamamlandığında kaynak nesne serbest bırakılabileceğinden gözlemleyici bloğunda self alanına zayıf bir referans kullandığınızdan emin olun. Ö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 almak istiyorsanız MLKModelDownloadDidSucceedNotification ve MLKModelDownloadDidFailNotification için gözlemcileri kaydedin. İndirme işlemleri uzun sürebileceğinden ve indirme nesnesini indirme işlemi tamamlandığında serbest bırakabileceğinden gözlemleyici bloğunda self için zayıf bir referans kullandığınızdan emin olun.

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