Справочник по платформе MLKitDigitalInkRecognition

MLKDigitalInkRecognitionModelIdentifier


@interface MLKDigitalInkRecognitionModelIdentifier : NSObject

Представляет модель распознавания цифровых рукописных данных, специфичную для языка, алфавита и, при необходимости, регионального варианта.

  • Языковая метка, соответствующая BCP 47, для этой модели.

    Декларация

    Цель-C

    @property (nonatomic, readonly) NSString *_Nonnull languageTag;
  • Подтег языка, т. е. двух- или трехбуквенный код языка ISO 639 для этой модели распознавания, например "en" для английского языка.

    Декларация

    Цель-C

    @property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
  • Подтег сценария, т. е. четырехбуквенный стандартный код алфавита ISO 15924, используемый в этой модели распознавания, например "Latn" для латинского алфавита или "Arab" для арабского алфавита.

    Декларация

    Цель-C

    @property (nonatomic, readonly, nullable) NSString *scriptSubtag;
  • Подтег региона, т. е. двухбуквенные коды регионов стандарта ISO 3166-1 Alpha 2 или набор цифровых кодов, определенных стандартом ООН M.49, например "DE" для Германии или "002" для Африки.

    Декларация

    Цель-C

    @property (nonatomic, readonly, nullable) NSString *regionSubtag;
  • Вместо этого используйте from(languageTag:) .

    Декларация

    Цель-C

    - (nonnull instancetype)init;
  • Возвращает Идентификатор модели, который лучше всего соответствует языку, алфавиту (если есть) и региону (если есть), закодированному в languageTag в формате BCP 47.

    Сопоставление выполняется с максимальной эффективностью, т. е. оно возвращает идентификатор модели, который лучше всего соответствует предоставленному languageTag используя следующую эвристику:

  • Если для субтега запрошенного языка не найден идентификатор модели, но последний является частью поддерживаемого макроязыка, сопоставьте его с макроязыком, например, "arb" (стандартный арабский язык) будет соответствовать "ar" (арабский язык).

  • Если сценарий не указан и для запрошенного языкового субтега не является явным сценарий, сопоставьте его с любым сценарием.

  • Если предоставленный или неявный подтег сценария является подмножеством поддерживаемого сценария, сопоставьте его также с последним, например, "zh-Hant" (китайский, традиционный хань) будет соответствовать "zh-Hani" (китайский, хань).

  • Если подтег региона не указан, сопоставьте его с любым регионом, отдавая предпочтение идентификаторам модели, в которых также не указан регион, например, "ro" (румынский язык) будет соответствовать "ro-RO" (румынский язык, Румыния).

  • Если вложенный тег региона указан, но не может быть сопоставлен, сопоставьте регионы, содержащие указанный регион, например, "fr-DZ" (Франция, Алжир) будет соответствовать "fr-002" (Франция, Африка).

    Если идентификатор модели не найден, возвращается nil .

  • Декларация

    Цель-C

    + (nullable MLKDigitalInkRecognitionModelIdentifier *)
        modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag
                                 error:(NSError *_Nullable *_Nullable)error;

    Параметры

    languageTag

    Языковой тег IETF BCP 47, представляющий запрошенный язык.

    error

    Необязательный объект сообщения об ошибке будет заполнен, если languageTag не может быть проанализирован.

    Возвращаемое значение

    идентификатор модели, точно соответствующий предоставленному языковому тегу, или наилучшее приблизительное совпадение, или nil , если подходящий идентификатор модели не найден. Также устанавливается в nil , если языковой тег не может быть проанализирован.

  • Возвращает идентификатор модели, который точно соответствует заданному languageTag .

    Отличается от from(LanguageTag:) тем, что он не пытается проанализировать languageTag (и, следовательно, не генерирует ошибок), а просто возвращает идентификатор модели, который точно соответствует languageTag , если он существует.

    Декларация

    Цель-C

    + (nullable MLKDigitalInkRecognitionModelIdentifier *)
        modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;

    Параметры

    languageTag

    Языковой тег IETF BCP 47 запрошенного идентификатора модели.

    Возвращаемое значение

    DigitalInkRecognitionModelIdentifier , точно соответствующий предоставленному languageTag , или nil , если он не найден.

  • Возвращает набор всех доступных идентификаторов модели.

    Декларация

    Цель-C

    + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
        allModelIdentifiers;
  • Возвращает набор идентификаторов модели, которые поддерживают данный языковой вложенный тег.

    Например, для "en" будет возвращен набор идентификаторов модели, содержащий enUs (английский, США), enUk (английский, Великобритания), enKe (английский, Кения) и т. д.

    Если не удается найти идентификаторы модели, поддерживающие языковой вложенный тег, возвращает пустой набор.

    Декларация

    Цель-C

    + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
        modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;

    Параметры

    languageSubtag

    Двух- или трехбуквенный языковой код ISO 639, например "en" для английского языка.

    Возвращаемое значение

    Набор идентификаторов модели, поддерживающих предоставленный languageSubtag , может быть пустым.

  • Возвращает набор идентификаторов модели, которые поддерживают данный вложенный тег сценария.

    Например, для "Latn" это вернет набор идентификаторов модели, содержащий enUs (английский, США), frFr (французский, Франция), guLatn (гуджарати, латиница) и т. д.

    Эта функция также возвращает идентификаторы моделей, которые поддерживают надмножество данного субтега сценария, например, для Hant (Хан, традиционный вариант), эта функция вернет модели распознавания zh-Hani поскольку Hant является подмножеством Hani (Хан, как традиционный, так и упрощенный вариант). варианты).

    Если идентификаторы модели, поддерживающие вложенный тег сценария, не найдены, возвращается пустой набор.

    Декларация

    Цель-C

    + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
        modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;

    Параметры

    scriptSubtag

    Четырехбуквенный стандартный код ISO 15924, например "Latn" для латинского алфавита или "Arab" для арабского алфавита.

    Возвращаемое значение

    Набор идентификаторов модели, поддерживающих предоставленный scriptSubtag , может быть пустым.

  • Возвращает набор идентификаторов модели, специфичных для данного вложенного тега региона.

    Например, для "CH" будет возвращен набор идентификаторов модели, содержащий deCh (немецкий, Швейцария), frCh (французский, Швейцария), itCh (итальянский, Швейцария) и rmCh (римский, Швейцария).

    Эта функция также возвращает идентификаторы модели, специфичные для регионов, которые содержат данный субтег региона или содержатся в данном субтеге региона, например, поиск DZ (Алжир) даст результаты, которые включают модель распознавания fr-002 (Франция, Африка), и наоборот.

    Если не удается найти идентификаторы модели, поддерживающие вложенный тег региона, возвращает пустой набор.

    Декларация

    Цель-C

    + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
        modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;

    Параметры

    regionSubtag

    Двухбуквенный стандартный код региона ISO 3166-1 Alpha 2 или один из цифровых кодов, определенных стандартом ООН M.49, например "DE" для Германии или "002" для Африки.

    Возвращаемое значение

    Набор идентификаторов модели, специфичных для предоставленного regionSubtag , может быть пустым.