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 dans 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 fichier .xcworkspace. ML Kit est compatible avec Xcode 12.4 ou version ultérieure.

Traduire une chaîne de texte

Pour traduire une chaîne entre deux langues:

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

    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 l'API d'identification de langue qui vous fournit un tag de langue. Ensuite, convertissez le tag de langue en énumération ML Kit. Le code dépend du langage que vous utilisez:

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

  2. Assurez-vous que le modèle de traduction requis a été téléchargé sur l'appareil. N'appelez translate(_:completion:) qu'une fois que 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.
    }];

    Les modèles de langage font environ 30 Mo. Par conséquent, ne les téléchargez pas inutilement et ne les téléchargez que via le Wi-Fi, sauf indication contraire de l'utilisateur. Supprimez les modèles lorsqu'ils 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 dans la langue source à 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 le transmet au gestionnaire d'achèvement.

Les cycles de vie des traducteurs sont contrôlés par ARC (comptabilisation automatique de références), qui est la convention recommandée pour le développement iOS. Les développeurs peuvent s'attendre à ce que le traducteur soit libéré une fois toutes les références fortes supprimées.

Les traducteurs peuvent occuper entre 30 Mo et 150 Mo lorsqu'ils sont chargés en mémoire. Les développeurs doivent garder à l'esprit le budget de mémoire de l'appareil ou de l'application lorsqu'ils créent des instances de traduction simultanées, et éviter de conserver trop de modèles de langage sur l'appareil à la fois.

Gérer explicitement les modèles de traduction

Lorsque vous utilisez l'API de traduction décrite ci-dessus, ML Kit télécharge automatiquement des modèles de traduction spécifiques à la langue sur l'appareil si nécessaire. Vous pouvez également gérer explicitement les modèles de traduction que vous souhaitez rendre disponibles sur l'appareil à l'aide de l'API de gestion des modèles de traduction de ML Kit. Cela peut être utile si vous souhaitez télécharger des modèles à l'avance ou supprimer les modèles inutiles de l'appareil.

Pour récupérer les modèles de traduction stockés sur l'appareil, procédez comme suit:

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

Si vous souhaitez obtenir l'état du téléchargement avec NotificationCenter, enregistrez des observateurs pour mlkitModelDownloadDidSucceed et mlkitModelDownloadDidFail. Veillez à utiliser une référence faible à self dans le bloc d'observateur, car les téléchargements peuvent prendre un certain temps et l'objet d'origine peut être libéré au terme du téléchargement. 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];

Si vous souhaitez obtenir l'état du téléchargement avec NSNotificationCenter, enregistrez des observateurs pour MLKModelDownloadDidSucceedNotification et MLKModelDownloadDidFailNotification. Veillez à utiliser une référence faible à self dans le bloc d'observateur, car les téléchargements peuvent prendre un certain temps et l'objet d'origine peut être libéré au terme du téléchargement.

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