Catch up on highlights from Firebase at Google I/O 2023. Learn more

Text mit ML Kit für iOS übersetzen

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

Bevor Sie beginnen

  1. Wenn Sie Ihrer App Firebase noch nicht hinzugefügt haben, befolgen Sie dazu die Schritte im Leitfaden „Erste Schritte“ .
  2. Schließen Sie die ML Kit-Bibliotheken in Ihre Poddatei ein: 
    pod 'Firebase/MLNLTranslate', '6.25.0'
    Nachdem Sie die Pods Ihres Projekts installiert oder aktualisiert haben, müssen Sie Ihr Xcode-Projekt mit seiner .xcworkspace .
  3. Importieren Sie in Ihrer App Firebase:

    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 und konfigurieren Sie es mit der Ausgangs- und Zielsprache:

    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 die Sprache des Eingabetexts nicht kennen, können Sie zuerst die Spracherkennungs-API verwenden. (Aber stellen Sie sicher, dass Sie nicht zu viele Sprachmodelle gleichzeitig auf dem Gerät behalten.)

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

    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, sofern der Benutzer nichts anderes angegeben hat. Sie sollten auch nicht benötigte Modelle löschen. Siehe Übersetzungsmodelle explizit verwalten .

  3. Nachdem Sie bestätigt haben, dass das Modell heruntergeladen wurde, übergeben Sie eine Textzeichenfolge in der Ausgangssprache an 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 Vervollständigungshandler.

Übersetzungsmodelle explizit verwalten

Wenn Sie die Übersetzungs-API wie oben beschrieben verwenden, lädt ML Kit nach 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 im Voraus 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 Downloadstatus mit NotificationCenter abrufen möchten, registrieren Sie Beobachter für firebaseMLModelDownloadDidSucceed und firebaseMLModelDownloadDidFail . Stellen Sie sicher, dass Sie im Beobachterblock einen schwachen Verweis auf sich self verwenden, da Downloads einige Zeit dauern können und das Ursprungsobjekt bis zum Abschluss des Downloads freigegeben werden kann. 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 Downloadstatus mit NSNotificationCenter , registrieren Sie Beobachter für FIRModelDownloadDidSucceedNotification und FIRModelDownloadDidFailNotification . Stellen Sie sicher, dass Sie im Beobachterblock einen schwachen Verweis auf sich self verwenden, da Downloads einige Zeit dauern können und das Ursprungsobjekt bis zum Abschluss des Downloads freigegeben werden kann.

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