MLKitDigitalInkRecognition 프레임워크 참조 | ML Kit


                    
                    
                    languageTag

이 모델의 BCP 47 준수 언어 태그입니다.

선언

Objective-C

@property (nonatomic, readonly) NSString *_Nonnull languageTag;


                    
                    
                    languageSubtag

언어 하위 태그입니다. 이 인식 모델의 2자리 또는 3자리 ISO 639 언어 코드입니다(예: 영어의 경우 "en").

선언

Objective-C

@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;


                    
                    
                    scriptSubtag

스크립트 하위 태그입니다. 인식 모델에 사용된 스크립트의 4자리 ISO 15924 표준 코드입니다(예: 라틴어 스크립트의 경우 "Latn", 아랍어 스크립트의 경우 "Arab").

선언

Objective-C

@property (nonatomic, readonly, nullable) NSString *scriptSubtag;


                    
                    
                    regionSubtag

지역 하위 태그(두 글자로 된 ISO 3166-1 Alpha 2 표준 지역 코드 또는 UN M.49 표준에서 정의한 숫자 코드(예: 독일의 경우 "DE", 아프리카의 경우 "002"))입니다.

선언

Objective-C

@property (nonatomic, readonly, nullable) NSString *regionSubtag;


                    
                    
                    -init

대신 from(languageTag:)를 사용하세요.

선언

Objective-C

- (nonnull instancetype)init;


                    
                    
                    +modelIdentifierFromLanguageTag:error:

BCP 47 형식의 languageTag로 인코딩된 언어, 스크립트 (있는 경우), 지역 (있는 경우)과 가장 일치하는 모델 식별자를 반환합니다.

일치는 최선의 방법입니다.즉, 다음 휴리스틱을 사용하여 제공된 languageTag와 가장 잘 일치하는 모델 식별자를 반환합니다.

요청된 언어 하위 태그에 모델 식별자를 찾을 수 없지만 후자가 지원되는 매크로 언어의 일부인 경우 매크로언어와 일치시킵니다. 예를 들어 "arb" (표준 아랍어)는 "ar" (아랍어)와 일치합니다.

스크립트가 제공되지 않고 요청된 언어 하위 태그에 암시적인 스크립트가 없는 경우 모든 스크립트와 일치시킵니다.

제공된 스크립트 하위 태그 또는 암시적 스크립트 하위 태그가 지원되는 스크립트의 하위 집합인 경우 스크립트 하위 태그와도 일치합니다. 예를 들어 "zh-Hant" (중국어, 한자)은 "zh-Hani"(중국어, 한자)과 일치합니다.

지역 하위 태그를 지정하지 않으면 지역을 지정하지 않는 모델 식별자를 선호하여 모든 지역과 일치시킵니다. 예를 들어 "ro" (루마니아어)는 "ro-RO" (루마니아어, 루마니아)과 일치합니다.

지역 하위 태그가 지정되었지만 일치시킬 수 없는 경우 지정된 지역이 포함된 지역과 일치합니다. 예를 들어 "fr-DZ" (프랑스어, 알제리)은 "fr-002" (프랑스어, 아프리카)과 일치합니다.

모델 식별자를 찾을 수 없으면 nil를 반환합니다.

선언

Objective-C

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

매개변수

`languageTag`	요청된 언어를 나타내는 IETF BCP 47 언어 태그입니다.
`error`	오류 메시지 객체(선택사항)로, `languageTag`를 파싱할 수 없는 경우 채워집니다.

반환 값

제공된 언어 태그와 정확히 일치하는 모델 식별자 또는 가장 근접한 일치 항목이거나 적절한 모델 식별자를 찾을 수 없는 경우 nil입니다. 언어 태그를 파싱할 수 없는 경우에도 nil로 설정합니다.


                    
                    
                    +modelIdentifierForLanguageTag:

지정된 languageTag와 정확하게 일치하는 모델 식별자를 반환합니다.

languageTag를 파싱하려고 시도하지 않아 오류를 생성하지 않고 languageTag와 정확하게 일치하는 모델 식별자(있는 경우)만 반환한다는 점에서 from(LanguageTag:)과 다릅니다.

선언

Objective-C

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

매개변수


                                languageTag

요청된 모델 식별자의 IETF BCP 47 언어 태그입니다.

반환 값

제공된 languageTag와 정확하게 일치하는 DigitalInkRecognitionModelIdentifier이거나 찾을 수 없는 경우 nil입니다.


                    
                    
                    +allModelIdentifiers

사용 가능한 모든 모델 식별자의 집합을 반환합니다.

선언

Objective-C

+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
    allModelIdentifiers;


                    
                    
                    +modelIdentifiersForLanguageSubtag:

지정된 언어 하위 태그를 지원하는 모델 식별자 집합을 반환합니다.

예를 들어 "en"의 경우 enUs(영어, 미국), enUk (영어, 영국), enKe (영어, 케냐) 등을 포함하는 모델 식별자 집합이 반환됩니다.

언어 하위 태그를 지원하는 모델 식별자를 찾을 수 없는 경우 빈 세트를 반환합니다.

선언

Objective-C

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

매개변수


                                languageSubtag

2자리 또는 3자리 ISO 639 언어 코드(예: 영어의 경우 "en").

반환 값

제공된 languageSubtag를 지원하는 모델 식별자 집합은 비어 있을 수 있습니다.


                    
                    
                    +modelIdentifiersForScriptSubtag:

지정된 스크립트 하위 태그를 지원하는 모델 식별자 집합을 반환합니다.

예를 들어 "Latn"의 경우 enUs (영어, 미국), frFr (프랑스어, 프랑스), guLatn (구자라트어, 라틴 문자) 등을 포함하는 모델 식별자 집합이 반환됩니다.

또한 이 함수는 지정된 스크립트 하위 태그의 상위 집합(예: Hant(한, 번체 변형)의 경우)을 지원하는 모델 식별자를 반환합니다. Hant가 Hani의 하위 집합(한, 번체 및 단순화된 변형 모두)이므로 이 함수는 zh-Hani 인식 모델을 반환합니다.

스크립트 하위 태그를 지원하는 모델 식별자를 찾을 수 없는 경우 빈 세트를 반환합니다.

선언

Objective-C

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

매개변수


                                scriptSubtag

4자리 ISO 15924 표준 코드입니다(예: 라틴어 스크립트의 경우 "Latn", 아랍어 스크립트의 경우 "Arab").

반환 값

제공된 scriptSubtag를 지원하는 모델 식별자 집합은 비어 있을 수 있습니다.


                    
                    
                    +modelIdentifiersForRegionSubtag:

지정된 지역 하위 태그와 관련된 모델 식별자 집합을 반환합니다.

예를 들어 "CH"의 경우 deCh (독일어, 스위스), frCh (프랑스어, 스위스), itCh (이탈리아어, 스위스), rmCh (로만시어, 스위스)가 포함된 모델 식별자 집합이 반환됩니다.

또한 이 함수는 지정된 지역 하위 태그가 포함되거나 지정된 지역 하위 태그에 포함된 지역에 해당하는 모델 식별자를 반환합니다. 예를 들어 DZ (알제리)를 검색하면 fr-002 (프랑스어, 아프리카) 인식 모델이 포함된 결과가 생성되며 그 반대의 경우도 마찬가지입니다.

지역 하위 태그를 지원하는 모델 식별자를 찾을 수 없는 경우 빈 집합을 반환합니다.

선언

Objective-C

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

매개변수


                                regionSubtag

두 글자로 된 ISO 3166-1 Alpha 2 표준 지역 코드 또는 UN M.49 표준에서 정의된 숫자 코드 중 하나(예: 독일의 경우 "DE", 아프리카의 경우 "002")

반환 값

제공된 regionSubtag에만 해당하는 모델 식별자 집합은 비어 있을 수 있습니다.