Tłumaczenie tekstu za pomocą ML Kit na iOS

Do tłumaczenia tekstu między językami możesz używać narzędzia ML Kit. ML Kit obsługuje ponad 50 języków.

Wypróbuj

Zanim zaczniesz

  1. W pliku Podfile uwzględnij te pody ML Kit: 
    pod 'GoogleMLKit/Translate', '3.2.0'
  2. Po zainstalowaniu lub zaktualizowaniu podów w projekcie otwórz projekt Xcode, korzystając z jego polecenia .xcworkspace. ML Kit obsługuje Xcode w wersji 12.4 lub nowszej.

Tłumaczenie ciągu tekstowego

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

  1. Utwórz obiekt Translator, konfigurując go za pomocą języka źródłowego i docelowego:

    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 tekstu wejściowego, możesz użyć interfejsu Language Identifiecation API, aby uzyskać tag języka. Następnie przekonwertuj tag języka na wyliczenie ML Kit. Kod zależy od używanego języka:

    Nie zapisuj na urządzeniu zbyt wielu modeli językowych.

  2. Upewnij się, że wymagany model tłumaczenia został pobrany na urządzenie. Nie dzwoń do: translate(_:completion:), dopóki nie wiesz, ż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, nie pobieraj ich więc bez potrzeby i tylko przez Wi-Fi, chyba że użytkownik określi inaczej. Gdy modele nie są już potrzebne, należy je usunąć. Zobacz Jednoznaczne zarządzanie modelami tłumaczenia.

  3. Gdy potwierdzisz, że model został pobrany, przekaż do translate(_:completion:) ciąg tekstu w języku źródłowym:

    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 i przekazuje go do modułu obsługi ukończenia.

Cykle życia tłumacza są kontrolowane przez ARC (automatyczne liczenie plików referencyjnych), co jest zalecaną konwencją dla programistów aplikacji na iOS. Deweloperzy mogą spodziewać się, że po usunięciu wszystkich ważnych plików referencyjnych Tłumacz zostanie usunięty.

Tłumacze wczytywane w pamięci mogą zająć od 30 do 150 MB. Podczas tworzenia równoczesnych instancji tłumacza deweloperzy powinni pamiętać o budżecie pamięci dla urządzenia lub aplikacji. Nie powinni też przechowywać zbyt wielu modeli językowych na urządzeniu jednocześnie.

Bezpośrednie zarządzanie modelami tłumaczenia

Gdy używasz interfejsu API tłumaczenia w sposób opisany powyżej, ML Kit automatycznie pobiera na urządzenie modele tłumaczenia dla poszczególnych języków. Możesz też bezpośrednio zarządzać modelami tłumaczenia, które mają być dostępne na urządzeniu, za pomocą interfejsu API zarządzania modelami translacji ML Kit. Jest to przydatne, gdy chcesz pobrać modele z wyprzedzeniem lub usunąć z urządzenia niepotrzebne modele.

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 za pomocą parametru NotificationCenter, zarejestruj obserwatorzy dla mlkitModelDownloadDidSucceed i mlkitModelDownloadDidFail. Pamiętaj, aby w bloku obserwacyjnym używać słabego odniesienia do self, ponieważ pobieranie może trochę potrwać, a obiekt źródłowy może zostać uwolniony do momentu zakończenia 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 za pomocą parametru NSNotificationCenter, zarejestruj obserwatorzy dla MLKModelDownloadDidSucceedNotification i MLKModelDownloadDidFailNotification. Pamiętaj, aby w bloku obserwatora używać słabego odniesienia do self, ponieważ pobieranie może trochę potrwać, a do momentu zakończenia pobierania obiekt źródłowy może zostać uwolniony.

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