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
- Przyjrzyj się przykładowej aplikacji, aby zobaczyć przykładowe użycie tego interfejsu API.
Zanim zaczniesz
- W pliku Podfile uwzględnij te pody ML Kit:
pod 'GoogleMLKit/Translate', '3.2.0'
- 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:
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:
- Szybkość: zadzwoń pod numer
TranslateLanguage.fromLanguageTag()
, aby otrzymaćTranslateLanguage
- Cel-C: zadzwoń pod numer
MLKTranslateLanguageForLanguageTag()
, aby otrzymaćMLKTranslateLanguage
Nie zapisuj na urządzeniu zbyt wielu modeli językowych.
- Szybkość: zadzwoń pod numer
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.
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]; }];