Übersetzen Sie Text mit ML Kit auf iOS

Sie können ML Kit verwenden, um Text zwischen Sprachen zu übersetzen. ML Kit unterstützt derzeit Übersetzung zwischen 59 Sprachen .

Bevor Sie beginnen

  1. Wenn Sie nicht bereits Firebase zu Ihrer App, tun Sie dies , indem Sie die Schritte im Leitfaden zur Inbetriebnahme .
  2. Fügen Sie die ML - Kit - Bibliotheken in Ihrem Podfile:
    pod 'Firebase/MLNLTranslate', '6.25.0'
    
    Nachdem Sie Ihr Projekt Pods installieren oder aktualisieren, sollten Sie Ihre Xcode - Projekt zu öffnen , seine Verwendung .xcworkspace .
  3. Importieren Sie Firebase in Ihre App:

    Schnell

    import Firebase

    Ziel c

    @import Firebase;

Übersetzen Sie eine Textfolge

So übersetzen Sie eine Zeichenfolge zwischen zwei Sprachen:

  1. Erstellen Sie ein Translator - Objekt, mit den Quell- und Zielsprachen zu konfigurieren:

    Schnell

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

    Ziel c

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

    Wenn Sie nicht die Sprache des eingegebenen Textes kennen, können Sie die Verwendung Sprachidentifikation API zuerst. (Achten Sie jedoch darauf, nicht zu viele Sprachmodelle gleichzeitig auf dem Gerät zu speichern.)

  2. Stellen Sie sicher, dass das erforderliche Übersetzungsmodell auf das Gerät heruntergeladen wurde. Rufen Sie nicht translate(_:completion:) bis Sie wissen , das Modell zur Verfügung steht.

    Schnell

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

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

    Sprachmodelle sind etwa 30 MB groß, laden Sie sie also nicht unnötig herunter und laden Sie sie nur über WLAN herunter, es sei denn, der Benutzer hat etwas anderes angegeben. Sie sollten auch nicht benötigte Modelle löschen. Siehe Explizit Übersetzung Modelle verwalten .

  3. Nachdem Sie das Modell bestätigen heruntergeladen wurde, eine Reihe von Text in der Ausgangssprache passieren zu translate(_:completion:) :

    Schnell

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

    Ziel c

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

    ML Kit übersetzt den Text in die von Ihnen konfigurierte Zielsprache und übergibt den übersetzten Text an den Abschluss-Handler.

Übersetzungsmodelle explizit verwalten

Wenn Sie die Übersetzungs-API wie oben beschrieben verwenden, lädt ML Kit bei Bedarf automatisch sprachspezifische Übersetzungsmodelle auf das Gerät herunter. Sie können die Übersetzungsmodelle, die auf dem Gerät verfügbar sein sollen, auch explizit verwalten, indem Sie die Übersetzungsmodell-Verwaltungs-API von ML Kit verwenden. Dies kann nützlich sein, wenn Sie Modelle vorzeitig herunterladen oder nicht benötigte Modelle vom Gerät löschen möchten.

So rufen Sie die auf dem Gerät gespeicherten Übersetzungsmodelle ab:

Schnell

let localModels = ModelManager.modelManager().downloadedTranslateModels

Ziel c

NSSet<FIRTranslateRemoteModel *> *localModels =
    [FIRModelManager modelManager].downloadedTranslateModels;

So löschen Sie ein Modell:

Schnell

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

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

So laden Sie ein Modell herunter:

Schnell

// 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
    )
)

Wenn Sie den Download - Status mit bekommen NotificationCenter , registrieren Beobachter für firebaseMLModelDownloadDidSucceed und firebaseMLModelDownloadDidFail . Achten Sie darauf , einen schwachen Hinweis auf die Verwendung self in dem Beobachter Block, da Downloads kann einige Zeit dauern, und das Ursprungsobjekt kann durch die Zeit , die Download - Oberflächen befreit werden. Zum Beispiel:

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

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

Wenn Sie den Download - Status mit bekommen NSNotificationCenter , registrieren Beobachter für FIRModelDownloadDidSucceedNotification und FIRModelDownloadDidFailNotification . Achten Sie darauf , einen schwachen Hinweis auf die Verwendung self in dem Beobachter Block, da Downloads kann einige Zeit dauern, und das Ursprungsobjekt kann durch die Zeit , die Download - Oberflächen befreit werden.

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