এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

iOS-এ ML Kit দিয়ে পাঠ্য অনুবাদ করুন

আপনি ভাষার মধ্যে পাঠ্য অনুবাদ করতে ML কিট ব্যবহার করতে পারেন। এমএল কিট 50 টিরও বেশি ভাষার মধ্যে অনুবাদ করতে পারে।

চেষ্টা করে দেখুন

এই API এর একটি উদাহরণ ব্যবহার দেখতে নমুনা অ্যাপের সাথে খেলুন।

আপনি শুরু করার আগে

আপনার পডফাইলে নিম্নলিখিত এমএল কিট পডগুলি অন্তর্ভুক্ত করুন:
```
pod 'GoogleMLKit/Translate', '15.5.0'
```
আপনি আপনার প্রোজেক্টের পড ইনস্টল বা আপডেট করার পরে, এটির .xcworkspace ব্যবহার করে আপনার Xcode প্রকল্পটি খুলুন। ML Kit Xcode সংস্করণ 12.4 বা তার বেশিতে সমর্থিত।

পাঠ্যের একটি স্ট্রিং অনুবাদ করুন

দুটি ভাষার মধ্যে একটি স্ট্রিং অনুবাদ করতে:

একটি Translator বস্তু তৈরি করুন, এটি উৎস এবং লক্ষ্য ভাষার সাথে কনফিগার করুন:
সুইফট
```
    // Create an English-German translator:
    let options = TranslatorOptions(sourceLanguage: .english, targetLanguage: .german)
    let englishGermanTranslator = Translator.translator(options: options)
```
উদ্দেশ্য-C
```
    // Create an English-German translator:
    MLKTranslatorOptions *options =
        [[MLKTranslatorOptions alloc] initWithSourceLanguage:MLKTranslateLanguageEnglish
                                              targetLanguage:MLKTranslateLanguageGerman];
    MLKTranslator *englishGermanTranslator =
        [MLKTranslator translatorwithOptions:options];
```
আপনি যদি ইনপুট পাঠ্যের ভাষা না জানেন তবে আপনি ভাষা সনাক্তকরণ API ব্যবহার করতে পারেন যা আপনাকে একটি ভাষা ট্যাগ দেয়। তারপর ভাষা ট্যাগটিকে একটি ML Kit enum এ রূপান্তর করুন। আপনি কোন ভাষা ব্যবহার করছেন তার উপর কোড নির্ভর করে:
- সুইফট: একটি TranslateLanguage পেতে TranslateLanguage.fromLanguageTag() এ কল করুন
- উদ্দেশ্য-C: একটি MLKTranslateLanguage পেতে MLKTranslateLanguageForLanguageTag() কে কল করুন
ডিভাইসে একসাথে অনেক ভাষা মডেল রাখা এড়িয়ে চলুন।
নিশ্চিত করুন যে প্রয়োজনীয় অনুবাদ মডেলটি ডিভাইসে ডাউনলোড করা হয়েছে। মডেলটি উপলব্ধ না হওয়া পর্যন্ত 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.
}
```
উদ্দেশ্য-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.
}];
```
ভাষার মডেলগুলি প্রায় 30MB, তাই সেগুলিকে অপ্রয়োজনীয়ভাবে ডাউনলোড করবেন না, এবং ব্যবহারকারী অন্যথায় নির্দিষ্ট না করলে শুধুমাত্র Wi-Fi ব্যবহার করে ডাউনলোড করুন৷ আপনার মডেলগুলি মুছে ফেলা উচিত যখন তাদের আর প্রয়োজন হয় না। অনুবাদ মডেলগুলি স্পষ্টভাবে পরিচালনা করুন দেখুন।

আপনি মডেলটি ডাউনলোড করা হয়েছে তা নিশ্চিত করার পরে, translate(_:completion:) :

সুইফট

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

          // Translation succeeded.
      }

উদ্দেশ্য-C

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

        // Translation succeeded.
      }];

ML Kit আপনার কনফিগার করা টার্গেট ল্যাঙ্গুয়েজ টেক্সট অনুবাদ করে এবং অনুবাদ করা টেক্সট কমপ্লিশন হ্যান্ডলারে পাঠায়।

অনুবাদক লাইফসাইকেলগুলি ARC (স্বয়ংক্রিয় রেফারেন্স গণনা) দ্বারা নিয়ন্ত্রিত হয়, যা iOS বিকাশের জন্য প্রস্তাবিত কনভেনশন। বিকাশকারীরা আশা করতে পারেন যে সমস্ত শক্তিশালী রেফারেন্স মুছে ফেলা হলে অনুবাদককে ডিলোকেট করা হবে।
মেমরিতে লোড করার সময় অনুবাদক 30MB-150MB দখল করতে পারে। সমসাময়িক অনুবাদক দৃষ্টান্ত তৈরি করার সময় ডেভেলপারদের ডিভাইস/অ্যাপের মেমরি বাজেটের কথা মাথায় রাখা উচিত এবং ডিভাইসে একসাথে অনেকগুলি ভাষার মডেল রাখা এড়িয়ে চলা উচিত।

স্পষ্টভাবে অনুবাদ মডেল পরিচালনা করুন

আপনি যখন উপরে বর্ণিত অনুবাদ API ব্যবহার করেন, তখন এমএল কিট স্বয়ংক্রিয়ভাবে প্রয়োজন অনুযায়ী ডিভাইসে ভাষা-নির্দিষ্ট অনুবাদ মডেল ডাউনলোড করে। এছাড়াও আপনি ML Kit-এর অনুবাদ মডেল ম্যানেজমেন্ট API ব্যবহার করে ডিভাইসে উপলব্ধ অনুবাদ মডেলগুলিকে স্পষ্টভাবে পরিচালনা করতে পারেন৷ আপনি যদি সময়ের আগে মডেলগুলি ডাউনলোড করতে চান বা ডিভাইস থেকে অপ্রয়োজনীয় মডেলগুলি মুছতে চান তবে এটি কার্যকর হতে পারে।

ডিভাইসে সংরক্ষিত অনুবাদ মডেলগুলি পেতে:

সুইফট

let localModels = ModelManager.modelManager().downloadedTranslateModels

উদ্দেশ্য-C

NSSet *localModels =
    [MLKModelManager modelManager].downloadedTranslateModels;

একটি মডেল মুছে ফেলতে:

সুইফট

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

উদ্দেশ্য-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.

একটি মডেল ডাউনলোড করতে:

সুইফট

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

উদ্দেশ্য-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];
 }];