Переведите текст с помощью ML Kit на iOS

Вы можете использовать ML Kit для перевода текста между языками. ML Kit в настоящее время поддерживает перевод между 59 языками .

Прежде чем вы начнете

Если вы еще не добавили Firebase в свое приложение, сделайте это, выполнив действия, описанные в руководстве по началу работы .
Включите библиотеки ML Kit в свой подфайл:
```
pod 'Firebase/MLNLTranslate', '6.25.0'
```
После установки или обновления модулей вашего проекта обязательно откройте проект Xcode, используя его .xcworkspace .
Импортируйте Firebase в свое приложение:
Быстрый
```
import Firebase
```
Цель-C
```
@import Firebase;
```

Перевести строку текста

Чтобы перевести строку между двумя языками:

Создайте объект Translator , настроив его с использованием исходного и целевого языков:

Быстрый

// Create an English-German translator:
let options = TranslatorOptions(sourceLanguage: .en, targetLanguage: .de)
let englishGermanTranslator = NaturalLanguage.naturalLanguage().translator(options: options)

Цель-C

// Create an English-German translator:
FIRTranslatorOptions *options =
    [[FIRTranslatorOptions alloc] initWithSourceLanguage:FIRTranslateLanguageEN
                                          targetLanguage:FIRTranslateLanguageDE];
FIRTranslator *englishGermanTranslator =
    [[FIRNaturalLanguage naturalLanguage] translatorWithOptions:options];

Если вы не знаете язык входного текста, вы можете сначала использовать API идентификации языка . (Но убедитесь, что вы не храните на устройстве слишком много языковых моделей одновременно.)

Убедитесь, что на устройство загружена необходимая модель перевода. Не вызывайте 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

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 МБ, поэтому не загружайте их без необходимости и загружайте только через 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 переводит текст на настроенный вами целевой язык и передает переведенный текст обработчику завершения.

Явное управление моделями перевода

Когда вы используете API перевода, как описано выше, ML Kit автоматически загружает на устройство модели перевода для конкретного языка по мере необходимости. Вы также можете явно управлять моделями перевода, которые вы хотите использовать на устройстве, с помощью API управления моделями перевода ML Kit. Это может быть полезно, если вы хотите заранее загрузить модели или удалить ненужные модели с устройства.

Чтобы получить модели перевода, хранящиеся на устройстве:

Быстрый

let localModels = ModelManager.modelManager().downloadedTranslateModels

Цель-C

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

Цель-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.
                                           }];

Чтобы скачать модель:

Быстрый

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

Цель-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];
 }];