iOS पर एमएल किट की मदद से टेक्स्ट का अनुवाद करना

एक से दूसरी भाषा में टेक्स्ट का अनुवाद करने के लिए, एमएल किट का इस्तेमाल किया जा सकता है. मशीन लर्निंग (ML) किट वर्तमान में इनके बीच अनुवाद का समर्थन करता है: 59 भाषाएं.

शुरू करने से पहले

1. अगर आपने पहले से अपने ऐप्लिकेशन में Firebase नहीं जोड़ा है, तो ऐसा करने के लिए शुरुआती निर्देश में दिए गए चरणों को पूरा करें.
2. अपनी Podfile में ML Kit लाइब्रेरी शामिल करें:

   pod 'Firebase/MLNLTranslate', '6.25.0'
   

   प्रोजेक्ट के Pods को इंस्टॉल या अपडेट करने के बाद, अपना Xcode ज़रूर खोलें प्रोजेक्ट को .xcworkspace का इस्तेमाल करके बनाया गया है.
3. अपने ऐप्लिकेशन में Firebase इंपोर्ट करें:

   Swift

   import Firebase

   Objective-C

   @import Firebase;

टेक्स्ट की किसी स्ट्रिंग का अनुवाद करना

दो भाषाओं के बीच स्ट्रिंग का अनुवाद करने के लिए:

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

   अगर आपको इनपुट टेक्स्ट की भाषा नहीं आती है, तो भाषा आइडेंटिफ़िकेशन एपीआई को पहले सबमिट करें. (लेकिन एक बार में डिवाइस पर बहुत ज़्यादा भाषा मॉडल नहीं रखें.)

2. पक्का करें कि डिवाइस पर ज़रूरी अनुवाद मॉडल डाउनलोड किया गया हो. जब तक आपको यह पता न हो कि मॉडल उपलब्ध है, तब तक 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 एमबी होता है. इसलिए, उन्हें बिना ज़रूरत के डाउनलोड न करें और उन्हें सिर्फ़ वाई-फ़ाई का इस्तेमाल करके डाउनलोड करें, जब तक कि उपयोगकर्ता ने ऐसा न किया हो. आपने लोगों तक पहुंचाया मुफ़्त में ग़ैर-ज़रूरी मॉडल को भी मिटाना चाहिए. अनुवाद करने वाले मॉडल को साफ़ तौर पर मैनेज करना लेख पढ़ें.

3. मॉडल के डाउनलोड होने की पुष्टि करने के बाद, टेक्स्ट की एक स्ट्रिंग 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.
   }];
   

   एमएल किट, टेक्स्ट को आपकी कॉन्फ़िगर की गई टारगेट भाषा में अनुवाद करती है और यह अनुवाद किए गए टेक्स्ट को पूरा होने वाले हैंडलर को भेजता है.

अनुवाद वाले मॉडल को साफ़ तौर पर मैनेज करना

अगर ऊपर बताए गए तरीके से Translate API का इस्तेमाल किया जाता है, तो ML Kit अपने-आप ज़रूरत पड़ने पर, डिवाइस पर अलग-अलग भाषाओं के अनुवाद के मॉडल डाउनलोड करता है. आपने लोगों तक पहुंचाया मुफ़्त में उन अनुवाद मॉडल को भी स् पष्ट रूप से प्रबंधित कर सकता है जिन्हें आप ML Kit के अनुवाद मॉडल प्रबंधन API (एपीआई) का इस्तेमाल करके डिवाइस. यह काम किया जा सकता है अगर आप समय से पहले मॉडल डाउनलोड करना चाहें, या ग़ैर-ज़रूरी मॉडल मिटाना हो, तो यह काम आ सकता है डिवाइस से.

डिवाइस पर अनुवाद के मॉडल सेव करने के लिए:

let localModels = ModelManager.modelManager().downloadedTranslateModels

NSSet<FIRTranslateRemoteModel *> *localModels =
    [FIRModelManager modelManager].downloadedTranslateModels;

मॉडल मिटाने के लिए:

// 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.
}

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

मॉडल डाउनलोड करने के लिए:

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

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

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