MLKitLanguageID Framework Reference

Page Summary

• The MLKLanguageIdentification class identifies the primary language or potential languages within a given text.

• It offers methods to get an instance with default or custom options using languageIdentification and languageIdentificationWithOptions:.

• The identifyLanguageForText:completion: method determines the main language, while identifyPossibleLanguagesForText:completion: identifies multiple potential languages.

• Both identification methods process text input (truncated to 200 characters for optimal accuracy) and provide results via completion handlers.

MLKLanguageIdentification

@interface MLKLanguageIdentification : NSObject

The LanguageIdentification class that identifies the main language or possible languages for the given text.

• +languageIdentification

  Gets a language identification instance with the default options.

  Declaration

  Objective-C

  + (nonnull MLKLanguageIdentification *)languageIdentification;

  Return Value

  A new instance of LanguageIdentification with the default options.

• +languageIdentificationWithOptions:

  Gets a language identification instance with the given options.

  Declaration

  Objective-C

  + (nonnull MLKLanguageIdentification *)languageIdentificationWithOptions:
      (nonnull MLKLanguageIdentificationOptions *)options;

  Parameters

  options

  The options used for language identification.

  Return Value

  A new instance of LanguageIdentification with the given options.

• -identifyLanguageForText:completion:

  Identifies the main language for the given text.

  Declaration

  Objective-C

  - (void)identifyLanguageForText:(nonnull NSString *)text
                       completion:(nonnull MLKIdentifyLanguageCallback)completion;

  Parameters

  text	The input text to use for identifying the language. Inputs longer than 200 characters are truncated to 200 characters, as longer input does not improve the detection accuracy.
  completion	Handler to call back on the main queue with the identified language tag or error.

• -identifyPossibleLanguagesForText:completion:

  Identifies possible languages for the given text.

  Declaration

  Objective-C

  - (void)identifyPossibleLanguagesForText:(nonnull NSString *)text
                                completion:
                                    (nonnull MLKIdentifyPossibleLanguagesCallback)
                                        completion;

  Parameters

  text	The input text to use for identifying the language. Inputs longer than 200 characters are truncated to 200 characters, as longer input does not improve the detection accuracy.
  completion	Handler to call back on the main queue with identified languages or error.

• -init

  Unavailable.

  Declaration

  Objective-C

  - (nonnull instancetype)init;