iOS-এ ML Kit-এর সাহায্যে টেক্সট অনুবাদ করা

আপনি ML Kit ব্যবহার করে এক ভাষা থেকে অন্য ভাষায় টেক্সট অনুবাদ করতে পারবেন। ML Kit ৫০টির বেশি ভাষার মধ্যে অনুবাদ করতে পারে।

মনে রাখবেন: ML Kit iOS API শুধুমাত্র ৬৪-বিট ডিভাইসে চলে। আপনি যদি 32-বিট সাপোর্ট সহ অ্যাপ তৈরি করেন, তাহলে এই API ব্যবহার করার আগে ডিভাইসের আর্কিটেকচার চেক করুন।

এটি ব্যবহার করে দেখুন

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

শুরু করার আগে

1. আপনার Podfile-এ নিম্নলিখিত ML Kit পড অন্তর্ভুক্ত করুন:

   pod 'GoogleMLKit/Translate', '8.0.0'
   

2. আপনার প্রোজেক্টের Pods ইনস্টল বা আপডেট করার পরে, .xcworkspace ব্যবহার করে আপনার Xcode প্রোজেক্ট খুলুন। Xcode ভার্সন 12.4 বা তার পরবর্তী ভার্সনে ML Kit কাজ করে।

টেক্সটের স্ট্রিং অনুবাদ করা

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

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

   ইনপুট টেক্সটের ভাষা আপনার জানা না থাকলে, আপনি ভাষা শনাক্তকরণ API ব্যবহার করতে পারেন যা আপনাকে একটি ভাষা ট্যাগ দেয়। তারপর ভাষা ট্যাগকে ML Kit এনামে কনভার্ট করুন। আপনি কোন ভাষা ব্যবহার করছেন তার উপর কোড নির্ভর করে:

   • Swift: TranslateLanguage পেতে TranslateLanguage.fromLanguageTag() নম্বরে কল করুন
   • Objective-C: MLKTranslateLanguageForLanguageTag()-এ কল করে MLKTranslateLanguage পান

   ডিভাইসে একসাথে অনেক বেশি ল্যাঙ্গুয়েজ মডেল রাখা এড়িয়ে চলুন।

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

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

   ল্যাঙ্গুয়েজ মডেলের সাইজ প্রায় ৩০ এমবি, তাই অপ্রয়োজনীয়ভাবে সেগুলি ডাউনলোড করবেন না এবং ব্যবহারকারী অন্য কিছু নির্দিষ্ট না করে থাকলে, শুধুমাত্র ওয়াই-ফাই ব্যবহার করেই সেগুলি ডাউনলোড করুন। মডেলের প্রয়োজন ফুরিয়ে গেলে সেটি মুছে দেওয়া উচিত। অনুবাদ মডেল স্পষ্টভাবে ম্যানেজ করা দেখুন।

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

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

ট্রান্সলেটর লাইফসাইকেল ARC (অটোমেটিক রেফারেন্স কাউন্টিং) দ্বারা নিয়ন্ত্রিত হয়, যা iOS ডেভেলপমেন্টের জন্য সাজেস্ট করা কনভেনশন। ডেভেলপাররা আশা করতে পারেন যে সব শক্তিশালী রেফারেন্স সরিয়ে দেওয়ার পরে Translator-এর বরাদ্দ বাতিল করা হবে।

মেমরিতে লোড করা হলে, অনুবাদক ৩০ এমবি-১৫০ এমবি জায়গা নিতে পারে। একসাথে একাধিক ট্রান্সলেটর ইনস্ট্যান্স তৈরি করার সময় ডেভেলপারদের ডিভাইসের/অ্যাপের মেমরি বাজেট মাথায় রাখতে হবে এবং ডিভাইসে একসাথে অনেক বেশি ল্যাঙ্গুয়েজ মডেল রাখা এড়িয়ে চলতে হবে।

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

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

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

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