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
, может быть пустым.