एक से दूसरी भाषा में टेक्स्ट का अनुवाद करने के लिए, एमएल किट का इस्तेमाल किया जा सकता है. फ़िलहाल, ML Kit 59 भाषाओं के बीच अनुवाद किया जा सकता है.
शुरू करने से पहले
- अगर आपने पहले से ही अपने ऐप्लिकेशन में Firebase नहीं जोड़ा है, तो शुरुआती निर्देश में दिए गए निर्देशों का पालन करके ऐसा करें.
- अपनी Podfile में ML Kit लाइब्रेरी शामिल करें:
pod 'Firebase/MLNLTranslate', '6.25.0'
अपने प्रोजेक्ट के पॉड को इंस्टॉल या अपडेट करने के बाद, पक्का करें कि आपने Xcode प्रोजेक्ट को इसके.xcworkspace
का इस्तेमाल करके खोला हो. - अपने ऐप्लिकेशन में, Firebase इंपोर्ट करें:
Swift
import Firebase
Objective-C
@import Firebase;
टेक्स्ट की किसी स्ट्रिंग का अनुवाद करना
दो भाषाओं के बीच स्ट्रिंग का अनुवाद करने के लिए:
एक
Translator
ऑब्जेक्ट बनाएं, उसे सोर्स और टारगेट भाषाओं के साथ कॉन्फ़िगर करें:Swift
// Create an English-German translator: let options = TranslatorOptions(sourceLanguage: .en, targetLanguage: .de) let englishGermanTranslator = NaturalLanguage.naturalLanguage().translator(options: options)
Objective-C
// Create an English-German translator: FIRTranslatorOptions *options = [[FIRTranslatorOptions alloc] initWithSourceLanguage:FIRTranslateLanguageEN targetLanguage:FIRTranslateLanguageDE]; FIRTranslator *englishGermanTranslator = [[FIRNaturalLanguage naturalLanguage] translatorWithOptions:options];
अगर आपको इनपुट टेक्स्ट की भाषा नहीं आती है, तो सबसे पहले भाषा की पहचान करने वाला एपीआई इस्तेमाल करें. (हालाँकि, डिवाइस पर एक साथ कई लैंग्वेज मॉडल न रखें.)
पक्का करें कि डिवाइस पर ज़रूरी अनुवाद मॉडल डाउनलोड किया गया हो. जब तक आपको यह पता न हो कि मॉडल उपलब्ध है, तब तक
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
FIRModelDownloadConditions *conditions = [[FIRModelDownloadConditions alloc] initWithAllowsCellularAccess:NO allowsBackgroundDownloading:YES]; [englishGermanTranslator downloadModelIfNeededWithConditions:conditions completion:^(NSError *_Nullable error) { if (error != nil) { return; } // Model downloaded successfully. Okay to start translating. }];
भाषा के मॉडल का साइज़ करीब 30 एमबी होता है. इसलिए, इन्हें बेवजह डाउनलोड न करें और सिर्फ़ वाई-फ़ाई का इस्तेमाल करके ही डाउनलोड करें. ऐसा तब तक करें, जब तक उपयोगकर्ता ने कुछ अलग न बताया हो. आपको ऐसे मॉडल भी मिटा देने चाहिए जिनकी ज़रूरत नहीं है. अनुवाद करने वाले मॉडल को साफ़ तौर पर मैनेज करना लेख पढ़ें.
मॉडल के डाउनलोड होने की पुष्टि करने के बाद,
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, टेक्स्ट का अनुवाद आपकी कॉन्फ़िगर की गई टारगेट भाषा में करता है. साथ ही, अनुवाद किए गए टेक्स्ट को पूरा होने वाले हैंडलर को भेजता है.
अनुवाद वाले मॉडल को साफ़ तौर पर मैनेज करना
अगर ऊपर बताए गए तरीके से Translate API का इस्तेमाल किया जाता है, तो ML Kit ज़रूरत के हिसाब से डिवाइस पर अलग-अलग भाषाओं के अनुवाद वाले मॉडल अपने-आप डाउनलोड करता है. आप मशीन पर काम करने वाले अनुवाद के उन मॉडल को भी मैनेज कर सकते हैं जिन्हें आपको डिवाइस पर उपलब्ध कराना है. ऐसा करने के लिए, ML Kit के अनुवाद मॉडल मैनेजमेंट एपीआई का इस्तेमाल किया जा सकता है. यह तब काम आ सकता है, जब आपको मॉडल समय से पहले डाउनलोड करना हो या डिवाइस से अनचाहे मॉडल मिटाने हों.
डिवाइस पर अनुवाद के मॉडल सेव करने के लिए:
Swift
let localModels = ModelManager.modelManager().downloadedTranslateModels
Objective-C
NSSet<FIRTranslateRemoteModel *> *localModels =
[FIRModelManager modelManager].downloadedTranslateModels;
मॉडल मिटाने के लिए:
Swift
// Delete the German model if it's on the device.
let deModel = TranslateRemoteModel.translateRemoteModel(language: .de)
ModelManager.modelManager().deleteDownloadedModel(deModel) { error in
guard error == nil else { return }
// Model deleted.
}
Objective-C
// Delete the German model if it's on the device.
FIRTranslateRemoteModel *deModel =
[FIRTranslateRemoteModel translateRemoteModelWithLanguage:FIRTranslateLanguageDE];
[[FIRModelManager modelManager] deleteDownloadedModel:deModel
completion:^(NSError * _Nullable error) {
if (error != nil) {
return;
}
// Model deleted.
}];
मॉडल डाउनलोड करने के लिए:
Swift
// Download the French model.
let frModel = TranslateRemoteModel.translateRemoteModel(language: .fr)
// Keep a reference to the download progress so you can check that the model
// is available before you use it.
progress = ModelManager.modelManager().download(
frModel,
conditions: ModelDownloadConditions(
allowsCellularAccess: false,
allowsBackgroundDownloading: true
)
)
अगर आपको NotificationCenter
की मदद से डाउनलोड की स्थिति चाहिए, तो firebaseMLModelDownloadDidSucceed
और firebaseMLModelDownloadDidFail
के लिए ऑब्ज़र्वर रजिस्टर करें. ऑब्ज़र्वर ब्लॉक में, self
के लिए कमज़ोर रेफ़रंस का इस्तेमाल करना न भूलें. ऐसा इसलिए, क्योंकि डाउनलोड होने में कुछ समय लग सकता है. साथ ही, डाउनलोड पूरा होने तक, ओरिजनल ऑब्जेक्ट को खाली किया जा सकता है. उदाहरण के लिए:
NotificationCenter.default.addObserver(
forName: .firebaseMLModelDownloadDidSucceed,
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 == frModel
else { return }
// The model was downloaded and is available on the device
}
NotificationCenter.default.addObserver(
forName: .firebaseMLModelDownloadDidFail,
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.
FIRModelDownloadConditions *conditions =
[[FIRModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
allowsBackgroundDownloading:YES];
FIRTranslateRemoteModel *frModel =
[FIRTranslateRemoteModel translateRemoteModelWithLanguage:FIRTranslateLanguageFR];
// Keep a reference to the download progress so you can check that the model
// is available before you use it.
self.downloadProgress = [[FIRModelManager modelManager] downloadModel:frModel
conditions:conditions];
अगर आपको NSNotificationCenter
की मदद से डाउनलोड की स्थिति चाहिए, तो FIRModelDownloadDidSucceedNotification
और FIRModelDownloadDidFailNotification
के लिए ऑब्ज़र्वर रजिस्टर करें. ऑब्ज़र्वर ब्लॉक में self
के लिए कमज़ोर रेफ़रंस का इस्तेमाल करना न भूलें. ऐसा इसलिए, क्योंकि डाउनलोड होने में कुछ समय लग सकता है. साथ ही, डाउनलोड पूरा होने से पहले, ऑरिजिन ऑब्जेक्ट को खाली किया जा सकता है.
__block MyViewController *weakSelf = self;
[NSNotificationCenter.defaultCenter
addObserverForName:FIRModelDownloadDidSucceedNotification
object:nil
queue:nil
usingBlock:^(NSNotification * _Nonnull note) {
if (weakSelf == nil | note.userInfo == nil) {
return;
}
FIRTranslateRemoteModel *model = note.userInfo[FIRModelDownloadUserInfoKeyRemoteModel];
if ([model isKindOfClass:[FIRTranslateRemoteModel class]]
&& model == frModel) {
// The model was downloaded and is available on the device
}
}];
[NSNotificationCenter.defaultCenter
addObserverForName:FIRModelDownloadDidFailNotification
object:nil
queue:nil
usingBlock:^(NSNotification * _Nonnull note) {
if (weakSelf == nil | note.userInfo == nil) {
return;
}
NSError *error = note.userInfo[FIRModelDownloadUserInfoKeyError];
}];