इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

इसे आज़माएं

इस एपीआई के इस्तेमाल का उदाहरण देखने के लिए, ऐप्लिकेशन के नमूने का इस्तेमाल करें.

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

अपनी Podfile में ये ML किट पॉड शामिल करें:
```
pod 'GoogleMLKit/Translate', '3.2.0'
```
अपने प्रोजेक्ट के पॉड इंस्टॉल करने या अपडेट करने के बाद, अपने .xcworkspaceकोड का इस्तेमाल करके Xcode प्रोजेक्ट खोलें. ML किट, Xcode के 12.4 या इसके बाद के वर्शन पर काम करती है.

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

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

Translator ऑब्जेक्ट बनाएं, उसे स्रोत और टारगेट भाषाओं के साथ कॉन्फ़िगर करें:
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];
```
अगर आपको इनपुट टेक्स्ट की भाषा नहीं आती है, तो आप भाषा पहचान एपीआई का इस्तेमाल कर सकते हैं. यह आपको भाषा टैग देता है. फिर भाषा टैग को ML Kit enum में बदलें. कोड इस बात पर निर्भर करता है कि आप किस भाषा का इस्तेमाल कर रहे हैं:
- स्विफ़्ट: TranslateLanguage पाने के लिए TranslateLanguage.fromLanguageTag() पर कॉल करें
- मकसद-C: MLKTranslateLanguage पाने के लिए, MLKTranslateLanguageForLanguageTag() को कॉल करें
डिवाइस पर एक साथ कई भाषा मॉडल न रखें.
पक्का करें कि डिवाइस पर ज़रूरी अनुवाद मॉडल डाउनलोड किया गया हो. जब तक आपको मॉडल के उपलब्ध होने की जानकारी न हो, तब तक 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
```
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.
}];
```
भाषा मॉडल करीब 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 किट, टेक्स्ट को आपकी टारगेट की गई भाषा में अनुवाद करता है. साथ ही, अनुवाद किए गए टेक्स्ट को पूरा करने वाले हैंडलर को भेज देता है.

अनुवादक लाइफ़साइकल को ARC (अपने-आप होने वाली पहचान की गिनती) से कंट्रोल किया जाता है, जो iOS डेवलपमेंट के लिए सुझाया गया तरीका है. सभी मज़बूत पहचान फ़ाइलों को हटाने के बाद, डेवलपर अनुवादित होने की उम्मीद कर सकते हैं.

मेमोरी में लोड करने पर, अनुवाद करने वाले लोग 30 एमबी से 150 एमबी तक की जगह ले सकते हैं. साथ-साथ अनुवादक इंस्टेंस बनाते समय, डेवलपर को डिवाइस/ऐप्लिकेशन के मेमोरी बजट को ध्यान में रखना चाहिए. साथ ही, डिवाइस पर एक साथ कई भाषा मॉडल का इस्तेमाल करने से बचना चाहिए.

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

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

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

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet *localModels =
    [MLKModelManager modelManager].downloadedTranslateModels;

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

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.

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

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 के साथ चाहिए, तो mlkitModelDownloadDidSucceed और mlkitModelDownloadDidFail के लिए ऑब्ज़र्वर रजिस्टर करें. ध्यान रखें कि ऑब्ज़र्वर ब्लॉक में self का कमज़ोर रेफ़रंस न हो, क्योंकि डाउनलोड होने में कुछ समय लग सकता है. साथ ही, डाउनलोड पूरा होने तक मूल ऑब्जेक्ट को आज़ाद किया जा सकता है. उदाहरण के लिए :

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 के साथ चाहिए, तो MLKModelDownloadDidSucceedNotification और MLKModelDownloadDidFailNotification के लिए ऑब्ज़र्वर रजिस्टर करें. ध्यान रखें कि ऑब्ज़र्वर ब्लॉक में self के कमज़ोर रेफ़रंस का इस्तेमाल किया जाए. इसकी वजह यह है कि डाउनलोड होने में कुछ समय लग सकता है. साथ ही, डाउनलोड पूरा होने से पहले, जिस ऑब्जेक्ट की शुरुआत की गई है वह काम का हो सकता है.

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