在 iOS 上使用 ML Kit 辨識文字語言

您可以使用 ML Kit 來識別文字字串的語言。您可以取得該字串中最有可能使用的語言，以及該字串中所有可能語言的可信度分數。

ML Kit 能夠以原生指令碼辨識 100 多種語言的文字。此外，系統可辨識阿拉伯文、保加利亞文、中文、希臘文、北印度文、日文和俄文版本。如需支援語言和指令碼的完整清單，請參閱完整清單。

立即體驗

事前準備

  1. 在 Podfile 中加入下列機器學習套件 Pod： 
    pod 'GoogleMLKit/LanguageID', '3.2.0'
  2. 安裝或更新專案的 Pod 後，使用 .xcworkspace 開啟 Xcode 專案。Xcode 12.4 以上版本支援機器學習套件。

識別字串的語言

如要識別字串的語言，請取得 LanguageIdentification 的例項，然後將字串傳送至 identifyLanguage(for:) 方法。

例如：

Swift

let languageId = NaturalLanguage.languageIdentification()

languageId.identifyLanguage(for: text) { (languageCode, error) in
  if let error = error {
    print("Failed with error: \(error)")
    return
  }
  if let languageCode = languageCode, languageCode != "und" {
    print("Identified Language: \(languageCode)")
  } else {
    print("No language was identified")
  }
}

Objective-C

MLKLanguageIdentification *languageId = [MLKLanguageIdentification languageIdentification];

[languageId identifyLanguageForText:text
                         completion:^(NSString * _Nullable languageCode,
                                      NSError * _Nullable error) {
                           if (error != nil) {
                             NSLog(@"Failed with error: %@", error.localizedDescription);
                             return;
                           }
                           if (![languageCode isEqualToString:@"und"] ) {
                             NSLog(@"Identified Language: %@", languageCode);
                           } else {
                             NSLog(@"No language was identified");
                           }
                         }];

如果呼叫成功，系統會將 BCP-47 語言代碼傳送至完成處理常式，以指示文字的語言。如果無法偵測到任何語言，系統就會傳送程式碼 und (未決定)。

根據預設，只有在機器學習辨識出信賴水準至少為 0.5 的語言時，才會傳回非 und 值。將 LanguageIdentificationOptions 物件傳送至 languageIdentification(options:)，即可變更此閾值：

Swift

let options = LanguageIdentificationOptions(confidenceThreshold: 0.4)
let languageId = NaturalLanguage.languageIdentification(options: options)

Objective-C

MLKLanguageIdentificationOptions *options =
    [[MLKLanguageIdentificationOptions alloc] initWithConfidenceThreshold:0.4];
MLKLanguageIdentification *languageId =
    [MLKLanguageIdentification languageIdentificationWithOptions:options];

取得字串可能的語言

如要取得字串最有可能的語言的信心值，請取得 LanguageIdentification 的例項，然後將字串傳送至 identifyPossibleLanguages(for:) 方法。

例如：

Swift

let languageId = NaturalLanguage.languageIdentification()

languageId.identifyPossibleLanguages(for: text) { (identifiedLanguages, error) in
  if let error = error {
    print("Failed with error: \(error)")
    return
  }
  guard let identifiedLanguages = identifiedLanguages,
    !identifiedLanguages.isEmpty,
    identifiedLanguages[0].languageCode != "und"
  else {
    print("No language was identified")
    return
  }

  print("Identified Languages:\n" +
    identifiedLanguages.map {
      String(format: "(%@, %.2f)", $0.languageCode, $0.confidence)
      }.joined(separator: "\n"))
}

Objective-C

MLKLanguageIdentification *languageId = [MLKLanguageIdentification languageIdentification];

[languageId identifyPossibleLanguagesForText:text
                                  completion:^(NSArray * _Nonnull identifiedLanguages,
                                               NSError * _Nullable error) {
  if (error != nil) {
    NSLog(@"Failed with error: %@", error.localizedDescription);
    return;
  }
  if (identifiedLanguages.count == 1
      && [identifiedLanguages[0].languageCode isEqualToString:@"und"] ) {
    NSLog(@"No language was identified");
    return;
  }
  NSMutableString *outputText = [NSMutableString stringWithFormat:@"Identified Languages:"];
  for (MLKIdentifiedLanguage *language in identifiedLanguages) {
    [outputText appendFormat:@"\n(%@, %.2f)", language.languageCode, language.confidence];
  }
  NSLog(outputText);
}];

如果呼叫成功，系統會將 IdentifiedLanguage 物件清單傳遞至接續處理常式。從各個物件中，您可以取得該語言的 BCP-47 程式碼，以及字串使用該語言的信心。請注意，這些值代表整個字串以特定語言編寫的信心；機器學習套件無法辨識單一字串中的多種語言。

根據預設，ML Kit 只會傳回可信度值為 0.01 以上的語言。將 LanguageIdentificationOptions 物件傳遞至 languageIdentification(options:) 即可變更這個門檻：

Swift

let options = LanguageIdentificationOptions(confidenceThreshold: 0.4)
let languageId = NaturalLanguage.languageIdentification(options: options)

Objective-C

MLKLanguageIdentificationOptions *options =
    [[MLKLanguageIdentificationOptions alloc] initWithConfidenceThreshold:0.4];
MLKLanguageIdentification *languageId =
    [MLKLanguageIdentification languageIdentificationWithOptions:options];

如果沒有語言符合此門檻，則清單有一個項目，值為 und。