Catch up on everthing we announced at this year's Firebase Summit. Learn more

आईओएस पर एमएल किट के साथ टेक्स्ट का अनुवाद करें

भाषाओं के बीच टेक्स्ट का अनुवाद करने के लिए आप एमएल किट का उपयोग कर सकते हैं। एमएल किट वर्तमान के बीच अनुवाद का समर्थन करता है 59 भाषाओं

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

  1. आप नहीं पहले से आपका ऐप्लिकेशन को Firebase जोड़ा है, तो में दिए चरणों का पालन करके ऐसा कर आरंभ करने की मार्गदर्शिका
  2. : अपने Podfile में एमएल किट पुस्तकालयों को शामिल करें
    pod 'Firebase/MLNLTranslate', '6.25.0'
    
    आप स्थापित करने या अपने प्रोजेक्ट की फलियाँ अद्यतन करते हैं, इसके उपयोग करते हुए अपने Xcode प्रोजेक्ट को खोलने के लिए यकीन है कि हो के बाद .xcworkspace
  3. अपने ऐप्लिकेशन में, Firebase आयात करें:

    तीव्र

    import Firebase

    उद्देश्य सी

    @import Firebase;

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

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

  1. एक बनाएं Translator वस्तु, स्रोत और लक्ष्य भाषाओं के साथ यह विन्यस्त करने:

    तीव्र

    // Create an English-German translator:
    let options = TranslatorOptions(sourceLanguage: .en, targetLanguage: .de)
    let englishGermanTranslator = NaturalLanguage.naturalLanguage().translator(options: options)
    

    उद्देश्य सी

    // Create an English-German translator:
    FIRTranslatorOptions *options =
        [[FIRTranslatorOptions alloc] initWithSourceLanguage:FIRTranslateLanguageEN
                                              targetLanguage:FIRTranslateLanguageDE];
    FIRTranslator *englishGermanTranslator =
        [[FIRNaturalLanguage naturalLanguage] translatorWithOptions:options];
    

    आप इनपुट पाठ की भाषा नहीं जानते हैं, तो आप उपयोग कर सकते हैं भाषा पहचान एपीआई पहले। (लेकिन सुनिश्चित करें कि आप डिवाइस पर एक साथ बहुत अधिक भाषा मॉडल न रखें।)

  2. सुनिश्चित करें कि आवश्यक अनुवाद मॉडल को डिवाइस पर डाउनलोड कर लिया गया है। कॉल मत translate(_:completion:) जब तक आप जानते हैं कि मॉडल उपलब्ध है।

    तीव्र

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

    उद्देश्य सी

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

    भाषा मॉडल लगभग 30MB के होते हैं, इसलिए उन्हें अनावश्यक रूप से डाउनलोड न करें, और उन्हें केवल वाईफाई का उपयोग करके डाउनलोड करें, जब तक कि उपयोगकर्ता ने अन्यथा निर्दिष्ट न किया हो। आपको अनावश्यक मॉडलों को भी हटा देना चाहिए। देखें स्पष्ट रूप से अनुवाद मॉडल का प्रबंधन

  3. आप इस बात की पुष्टि करने के बाद मॉडल डाउनलोड किया गया है, के लिए स्रोत भाषा में पाठ की एक स्ट्रिंग पारित translate(_:completion:) :

    तीव्र

    englishGermanTranslator.translate(text) { translatedText, error in
        guard error == nil, let translatedText = translatedText else { return }
    
        // Translation succeeded.
    }
    

    उद्देश्य सी

    [englishGermanTranslator translateText:text
                                completion:^(NSString *_Nullable translatedText,
                                             NSError *_Nullable error) {
      if (error != nil || translatedText == nil) {
        return;
      }
    
      // Translation succeeded.
    }];
    

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

स्पष्ट रूप से अनुवाद मॉडल प्रबंधित करें

जब आप ऊपर बताए अनुसार अनुवाद एपीआई का उपयोग करते हैं, तो एमएल किट स्वचालित रूप से आवश्यकतानुसार डिवाइस पर भाषा-विशिष्ट अनुवाद मॉडल डाउनलोड करता है। आप एमएल किट के अनुवाद मॉडल प्रबंधन एपीआई का उपयोग करके डिवाइस पर उपलब्ध अनुवाद मॉडल को स्पष्ट रूप से प्रबंधित कर सकते हैं। यह उपयोगी हो सकता है यदि आप समय से पहले मॉडल डाउनलोड करना चाहते हैं, या डिवाइस से अनावश्यक मॉडल हटाना चाहते हैं।

अनुवाद मॉडल को डिवाइस पर संग्रहीत करने के लिए:

तीव्र

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 , के लिए पर्यवेक्षकों रजिस्टर 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]
    // ...
}

उद्देश्य सी

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