Tłumaczenie tekstu za pomocą ML Kit na iOS

Do tłumaczenia tekstu między językami możesz używać pakietu ML Kit. Zestaw ML może tłumaczyć między więcej niż 50 języków.

Wypróbuj

Zanim zaczniesz

  1. W pliku Podfile umieść te pody ML Kit: 
    pod 'GoogleMLKit/Translate', '3.2.0'
  2. Po zainstalowaniu lub zaktualizowaniu podów projektu otwórz projekt Xcode za pomocą .xcworkspace ML Kit jest obsługiwany w Xcode w wersji 12.4 lub nowszej.

Tłumaczenie ciągu tekstowego

Aby przetłumaczyć ciąg znaków między dwoma językami:

  1. Utwórz obiekt Translator, konfigurując go ze źródłem i miejscem docelowym języki:

    Swift

        // Create an English-German translator:
    let options = TranslatorOptions(sourceLanguage: .english, targetLanguage: .german)
    let englishGermanTranslator = Translator.translator(options: options)

    Objective-C

        // Create an English-German translator:
    MLKTranslatorOptions *options =
        [[MLKTranslatorOptions alloc] initWithSourceLanguage:MLKTranslateLanguageEnglish
                                              targetLanguage:MLKTranslateLanguageGerman];
    MLKTranslator *englishGermanTranslator =
        [MLKTranslator translatorwithOptions:options];

    Jeśli nie znasz języka wprowadzania, możesz skorzystać z funkcji Język Identyfikacyjny interfejs API, który otrzymasz tag języka. Następnie przekonwertuj tag języka na wyliczanie ML Kit. Kod zależy od używanego języka:

    Unikaj przechowywania na urządzeniu zbyt wielu modeli językowych naraz.

  2. Upewnij się, że wymagany model tłumaczenia został pobrany na urządzenie. Nie dzwoń pod numer translate(_:completion:), dopóki nie upewnisz się, że model jest dostępny.

    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

    MLKModelDownloadConditions *conditions =
    [[MLKModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
[englishGermanTranslator downloadModelIfNeededWithConditions:conditions
                                                  completion:^(NSError *_Nullable error) {
  if (error != nil) {
    return;
  }
  // Model downloaded successfully. Okay to start translating.
}];

    Modele językowe mają około 30 MB, więc nie pobieraj ich niepotrzebnie. pobierać je tylko przez Wi-Fi, chyba że użytkownik określi inaczej. Ty powinni usuwać modele, gdy nie są już potrzebne. Zobacz Bezpośrednie zarządzanie modelami tłumaczenia.

  3. Po potwierdzeniu, że model został pobrany, przekaż ciąg tekstu w polu języka źródłowego do 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 tłumaczy tekst na skonfigurowany przez Ciebie język docelowy, przekazuje przetłumaczony tekst do modułu obsługi uzupełniania.

Cykle życia tłumaczy są kontrolowane przez ARC (automatyczne zliczanie plików referencyjnych), co jest zalecane w przypadku programowania na iOS. Programiści mogą się spodziewać tłumacza, który ma zostać przypisany do klienta po usunięciu wszystkich silnych odwołań.

Tłumaczenia mogą zajmować od 30 MB do 150 MB po załadowaniu do pamięci. Deweloperzy powinni Uwzględnij budżet pamięci urządzenia/aplikacji podczas tworzenia instancji translatorów i unikać przechowywania zbyt wielu modeli językowych na urządzeniu. za jednym razem.

Bezpośrednie zarządzanie modelami translacji

Jeśli używasz interfejsu Translation API w sposób opisany powyżej, ML Kit automatycznie pobiera na urządzenie modele tłumaczeń dla określonych języków. Ty można też bezpośrednio zarządzać modelami tłumaczenia, które mają być dostępne na swoim urządzeniu za pomocą interfejsu API do zarządzania modelami translacji ML Kit. Może to być przydatne, jeśli chcesz pobrać modele z wyprzedzeniem lub usunąć niepotrzebne modele z urządzenia.

Aby pobrać modele tłumaczenia zapisane na urządzeniu:

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet *localModels =
    [MLKModelManager modelManager].downloadedTranslateModels;

Aby usunąć model:

Swift

// Delete the German model if it's on the device.
let germanModel = TranslateRemoteModel.translateRemoteModel(language: .german)
ModelManager.modelManager().deleteDownloadedModel(germanModel) { error in
    guard error == nil else { return }
    // Model deleted.
}

Objective-C

// Delete the German model if it's on the device.
MLKTranslateRemoteModel *germanModel =
    [MLKTranslateRemoteModel translateRemoteModelWithLanguage:MLKTranslateLanguageGerman];
[[MLKModelManager modelManager] deleteDownloadedModel:germanModel
                                           completion:^(NSError * _Nullable error) {
                                               if (error != nil) {
                                                   return;
                                               }
                                               // Model deleted.

Aby pobrać model:

Swift

// Download the French model.
let frenchModel = TranslateRemoteModel.translateRemoteModel(language: .french)

// Keep a reference to the download progress so you can check that the model
// is available before you use it.
progress = ModelManager.modelManager().download(
    frenchModel,
    conditions: ModelDownloadConditions(
        allowsCellularAccess: false,
        allowsBackgroundDownloading: true
    )
)

Jeśli chcesz uzyskać stan pobierania w aplikacji NotificationCenter, zarejestruj się obserwatorzy mlkitModelDownloadDidSucceed i mlkitModelDownloadDidFail Pamiętaj, aby użyć słabego odniesienia do self w bloku obserwatora, ponieważ pobieranie może zająć trochę czasu, może zostać zwolniony przed zakończeniem pobierania. Na przykład:

NotificationCenter.default.addObserver(
    forName: .mlkitModelDownloadDidSucceed,
    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 == frenchModel
        else { return }
    // The model was downloaded and is available on the device
}

NotificationCenter.default.addObserver(
    forName: .mlkitModelDownloadDidFail,
    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.
MLKModelDownloadConditions *conditions =
    [[MLKModelDownloadConditions alloc] initWithAllowsCellularAccess:NO
                                         allowsBackgroundDownloading:YES];
MLKTranslateRemoteModel *frenchModel =
    [MLKTranslateRemoteModel translateRemoteModelWithLanguage:MLKTranslateLanguageFrench];

// Keep a reference to the download progress so you can check that the model
// is available before you use it.
self.downloadProgress = [[MLKModelManager modelManager] downloadModel:frenchModel
conditions:conditions];

Jeśli chcesz uzyskać stan pobierania w aplikacji NSNotificationCenter, zarejestruj się obserwatorzy MLKModelDownloadDidSucceedNotification i MLKModelDownloadDidFailNotification Pamiętaj, aby użyć słabego odniesienia do self w bloku obserwatora, ponieważ pobieranie może trochę potrwać. źródłowy obiekt może zostać uwolniony przed zakończeniem pobierania.

__block MyViewController *weakSelf = self;

[NSNotificationCenter.defaultCenter
 addObserverForName:MLKModelDownloadDidSucceedNotification
 object:nil
 queue:nil
 usingBlock:^(NSNotification * _Nonnull note) {
     if (weakSelf == nil | note.userInfo == nil) {
         return;
     }

     MLKTranslateRemoteModel *model = note.userInfo[MLKModelDownloadUserInfoKeyRemoteModel];
     if ([model isKindOfClass:[MLKTranslateRemoteModel class]]
         && model == frenchModel) {
         // The model was downloaded and is available on the device
     }
 }];

[NSNotificationCenter.defaultCenter
 addObserverForName:MLKModelDownloadDidFailNotification
 object:nil
 queue:nil
 usingBlock:^(NSNotification * _Nonnull note) {
     if (weakSelf == nil | note.userInfo == nil) {
         return;
     }

     NSError *error = note.userInfo[MLKModelDownloadUserInfoKeyError];
 }];