يمكنك استخدام حزمة تعلّم الآلة لترجمة النص بين اللغات. تتيح حزمة تعلّم الآلة حاليًا الترجمة بين 59 لغة.
قبل البدء
- إذا لم يسبق لك إضافة Firebase إلى تطبيقك، عليك اتّباع الخطوات الواردة في دليل البدء.
- تضمين مكتبات ML Kit في Podfile:
pod 'Firebase/MLNLTranslate', '6.25.0'
بعد تثبيت مجموعات Podfile الخاصة بمشروعك أو تعديلها، احرص على فتح مشروع Xcode الخاص بك باستخدام.xcworkspace
. - في تطبيقك، استورد Firebase:
Swift
import Firebase
Objective-C
@import Firebase;
ترجمة سلسلة من النص
لترجمة سلسلة بين لغتين:
أنشِئ عنصر
Translator
، مع ضبطه باستخدام اللغتَين المصدر والهدف:Swift
// Create an English-German translator: let options = TranslatorOptions(sourceLanguage: .en, targetLanguage: .de) let englishGermanTranslator = NaturalLanguage.naturalLanguage().translator(options: options)
Objective-C
// Create an English-German translator: FIRTranslatorOptions *options = [[FIRTranslatorOptions alloc] initWithSourceLanguage:FIRTranslateLanguageEN targetLanguage:FIRTranslateLanguageDE]; FIRTranslator *englishGermanTranslator = [[FIRNaturalLanguage naturalLanguage] translatorWithOptions:options];
إذا كنت لا تعرف لغة النص المُدخَل، يمكنك أولاً استخدام language identification API. (ولكن احرص على عدم الاحتفاظ بعدد كبير من النماذج اللغوية على جهازك مرة واحدة).
تأكَّد من تنزيل نموذج الترجمة المطلوب على الجهاز. يُرجى عدم الاتصال بـ "
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
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، ما لم يحدّد المستخدم غير ذلك. يجب عليك أيضًا حذف النماذج غير اللازمة. يُرجى الاطّلاع على إدارة نماذج الترجمة بوضوح.
بعد التأكّد من تنزيل النموذج، مرِّر سلسلة من النص باللغة المصدر إلى
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. وقد يكون هذا الإجراء مفيدًا إذا كنت تريد تنزيل النماذج مسبقًا أو حذف النماذج غير الضرورية من الجهاز.
لتخزين نماذج الترجمة على الجهاز:
Swift
let localModels = ModelManager.modelManager().downloadedTranslateModels
Objective-C
NSSet<FIRTranslateRemoteModel *> *localModels =
[FIRModelManager modelManager].downloadedTranslateModels;
لحذف نموذج:
Swift
// 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.
}
Objective-C
// 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.
}];
لتنزيل نموذج:
Swift
// 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]
// ...
}
Objective-C
// 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];
}];