Traduire du texte avec ML Kit sur iOS

Vous pouvez utiliser ML Kit pour traduire du texte d'une langue à une autre. ML Kit peut traduire entre plus de 50 langues.

Essayer

Avant de commencer

  1. Incluez les pods ML Kit suivants dans votre Podfile:
    pod 'GoogleMLKit/Translate', '3.2.0'
    
  2. Après avoir installé ou mis à jour les pods de votre projet, ouvrez votre projet Xcode à l'aide de son .xcworkspace ML Kit est compatible avec Xcode 12.4 ou version ultérieure.

Traduire une chaîne de texte

Pour traduire une chaîne dans deux langues:

  1. Créer un objet Translator en le configurant avec la source et la cible langues:

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

    Si vous ne connaissez pas la langue du texte d'entrée, vous pouvez utiliser la fonction Langue l'API Identification, vous attribue un tag de langue. Convertissez ensuite le tag de langue en une énumération ML Kit. Le code dépend du langage que vous utilisez:

    Évitez de conserver trop de modèles de langage sur l'appareil en même temps.

  2. Assurez-vous que le modèle de traduction requis a été téléchargé sur l'appareil. N'appelez translate(_:completion:) que lorsque vous savez que le modèle est disponible.

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

    La taille des modèles de langage est d'environ 30 Mo. Évitez donc de les télécharger inutilement. téléchargez-les uniquement via le Wi-Fi, sauf indication contraire de l'utilisateur. Toi supprimer les modèles qui ne sont plus nécessaires. Consultez Gérer explicitement les modèles de traduction.

  3. Après avoir vérifié que le modèle a été téléchargé, transmettez une chaîne de texte la langue source vers 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 traduit le texte dans la langue cible que vous avez configurée et transmet le texte traduit au gestionnaire d'achèvement.

Le cycle de vie des traducteurs est contrôlé par ARC (paiement de référence automatique), qui est la convention recommandée pour le développement sur iOS. Les développeurs peuvent s'attendre une fois toutes les références fortes supprimées.

Les traducteurs peuvent occuper entre 30 Mo et 150 Mo une fois chargés en mémoire. Les développeurs doivent Tenez compte du budget mémoire de l'appareil ou de l'application lorsque vous créez des des instances de traducteur, et évitez de conserver trop de modèles de langage sur l'appareil. en même temps.

Gérer explicitement les modèles de traduction

Lorsque vous utilisez l'API Translation comme décrit ci-dessus, ML Kit s'exécute automatiquement télécharge des modèles de traduction spécifiques à la langue sur l'appareil si nécessaire. Toi vous pouvez également gérer explicitement les modèles de traduction que vous souhaitez à l'aide de l'API de gestion des modèles de traduction de ML Kit. Il peut s'agir utile si vous souhaitez télécharger des modèles à l'avance ou supprimer des modèles inutiles de l'appareil.

Pour récupérer les modèles de traduction stockés sur l'appareil:

Swift

let localModels = ModelManager.modelManager().downloadedTranslateModels

Objective-C

NSSet *localModels =
    [MLKModelManager modelManager].downloadedTranslateModels;

Pour supprimer un modèle, procédez comme suit :

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.

Pour télécharger un modèle:

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

Pour connaître l'état du téléchargement auprès de NotificationCenter, inscrivez-vous observateurs pour mlkitModelDownloadDidSucceed et mlkitModelDownloadDidFail Veillez à utiliser une référence faible à self dans le bloc "Observer", car les téléchargements peuvent prendre un certain temps et que le fichier d'origine peut être libéré une fois le téléchargement terminé. Exemple :

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

Pour connaître l'état du téléchargement auprès de NSNotificationCenter, inscrivez-vous observateurs pour MLKModelDownloadDidSucceedNotification et MLKModelDownloadDidFailNotification Veillez à utiliser une référence faible pour self dans le bloc d'observation, étant donné que les téléchargements peuvent prendre un certain temps, et que l'objet d'origine peut être libéré une fois le téléchargement terminé.

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