ترجمة النص باستخدام حزمة تعلّم الآلة على نظام التشغيل iOS

يمكنك استخدام ML Kit لترجمة النص بين اللغات. تدعم ML Kit حاليًا الترجمة بين 59 لغة .

قبل ان تبدأ

  1. إذا لم تكن قد أضفت Firebase إلى تطبيقك بالفعل، فقم بذلك باتباع الخطوات الواردة في دليل البدء .
  2. قم بتضمين مكتبات ML Kit في ملف Podfile الخاص بك:
    pod 'Firebase/MLNLTranslate', '6.25.0'
    
    بعد تثبيت أو تحديث Pods لمشروعك، تأكد من فتح مشروع 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.
    }];
    

    يبلغ حجم نماذج اللغة حوالي 30 ميجابايت، لذا لا تقم بتنزيلها دون داعٍ، وقم بتنزيلها فقط باستخدام WiFi، ما لم يحدد المستخدم خلاف ذلك. يجب عليك أيضًا حذف النماذج غير الضرورية. راجع إدارة نماذج الترجمة بشكل صريح .

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

    تقوم ML Kit بترجمة النص إلى اللغة الهدف التي قمت بتكوينها وتمرير النص المترجم إلى معالج الإكمال.

إدارة نماذج الترجمة بشكل واضح

عند استخدام واجهة برمجة تطبيقات الترجمة كما هو موضح أعلاه، تقوم ML Kit تلقائيًا بتنزيل نماذج الترجمة الخاصة باللغة على الجهاز كما هو مطلوب. يمكنك أيضًا إدارة نماذج الترجمة التي تريدها متاحة على الجهاز بشكل صريح باستخدام واجهة برمجة تطبيقات إدارة نماذج الترجمة الخاصة بـ ML Kit. يمكن أن يكون هذا مفيدًا إذا كنت تريد تنزيل النماذج مسبقًا، أو حذف النماذج غير الضرورية من الجهاز.

للحصول على نماذج الترجمة المخزنة على الجهاز:

سويفت

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