Diller arasında metin çevirmek için ML Kit'i kullanabilirsiniz. ML Kiti 50'den fazla dil arasında çeviri yapabilir.
Deneyin
- Bu API'nin örnek bir kullanımını görmek için örnek uygulamayı inceleyin.
Başlamadan önce
- Aşağıdaki ML Kiti kapsüllerini Podfile'ınıza ekleyin:
pod 'GoogleMLKit/Translate', '3.2.0'
- Projenizin Kapsüllerini yükledikten veya güncelledikten sonra Xcode projenizi,
.xcworkspace
ile açın. ML Kit, Xcode 12.4 veya üzeri sürümlerde desteklenir.
Bir metin dizesini çevirme
Bir dizeyi iki dil arasında çevirmek için:
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 bir dil etiketi sağlayan LanguageIdentification API'yi kullanabilirsiniz. Daha sonra, dil etiketini ML Kit sıralamasına dönüştürür. Kod, kullandığınız dile bağlıdır:
- Swift:
TranslateLanguage
almak içinTranslateLanguage.fromLanguageTag()
numaralı telefonu arayın - Hedef-C:
MLKTranslateLanguage
kazanmak içinMLKTranslateLanguageForLanguageTag()
numaralı telefonu arayın
Cihazda aynı anda çok fazla dil modeli tutmaktan kaçının.
- Swift:
Gerekli çeviri modelinin cihaza indirildiğinden emin olun. Modelin kullanılabilir olduğundan emin olana kadar
translate(_:completion:)
adlı kişiyi 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 büyüklüğünde olduğundan bunları gereksiz yere indirmeyin ve kullanıcı aksini belirtmediği sürece yalnızca kablosuz bağlantı kullanarak indirin. Artık ihtiyaç duyulmayan modelleri silmelisiniz. Çeviri modellerini açık bir şekilde yönetme konusuna bakın.
Modelin indirildiğini onayladıktan sonra, kaynak dilde bir metin dizesini
translate(_:completion:)
hizmetine 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 Kiti, metni yapılandırdığınız hedef dile çevirir ve çevrilmiş metni tamamlama işleyiciye iletir.
Çevirmen yaşam döngüleri, iOS geliştirmede önerilen kural olan ARC (otomatik referans sayma) tarafından kontrol edilir. Geliştiriciler, tüm güçlü referanslar kaldırıldıktan sonra Çevirmen'in yerinin belirlenmesini bekleyebilir.
Çevirmenler, belleğe yüklendiklerinde 30 MB-150 MB arasında yer kaplayabilir. Geliştiriciler eşzamanlı çevirmen örnekleri oluştururken cihazın/uygulamanın bellek bütçesini göz önünde bulundurmalı ve cihazda aynı anda çok fazla dil modeli tutmaktan kaçınmalıdır.
Çeviri modellerini açık bir şekilde yönetme
Çeviri API'sini yukarıda açıklandığı şekilde kullandığınızda ML Kiti, dile özgü çeviri modellerini gereken şekilde cihaza otomatik olarak indirir. ML Kit'in çeviri modeli yönetim API'sini kullanarak cihazda kullanılmasını istediğiniz çeviri modellerini açıkça yönetebilirsiniz. Bu seçenek, modelleri önceden indirmek veya gereksiz modelleri cihazdan silmek istiyorsanız yararlı olabilir.
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 modeli 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şlemi biraz zaman alabileceği ve kaynak nesne, indirme işlemi tamamlandığında serbest bırakılabileceği için gözlemci bloğunda self
öğesine 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şlemi biraz zaman alabileceği ve kaynak nesne indirme işlemi tamamlandığında serbest bırakılabileceği için gözlemci bloğunda self
öğesine 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]; }];