MLKDigitalInkRecognitionModelIdentifier
@interface MLKDigitalInkRecognitionModelIdentifier : NSObject
Biểu thị một mô hình nhận dạng mực kỹ thuật số dành riêng cho một ngôn ngữ, tập lệnh và (không bắt buộc) biến thể theo khu vực.
-
Thẻ ngôn ngữ tuân thủ BCP 47 cho mô hình này.
Khai báo
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageTag;
-
Thẻ phụ ngôn ngữ, ví dụ: mã ngôn ngữ ISO 639 gồm 2 hoặc 3 chữ cái cho mô hình nhận dạng này, ví dụ:
"en"
cho tiếng Anh.Khai báo
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
-
Thẻ phụ của tập lệnh, tức là mã theo tiêu chuẩn ISO 15924 gồm bốn chữ cái của tập lệnh được sử dụng trong thẻ này mô hình nhận dạng, ví dụ:
"Latn"
cho chữ Latinh hoặc"Arab"
cho chữ Ả Rập.Khai báo
Objective-C
@property (nonatomic, readonly, nullable) NSString *scriptSubtag;
-
Thẻ phụ khu vực, tức là mã vùng tiêu chuẩn gồm hai chữ cái theo ISO 3166-1 Alpha 2 hoặc tập hợp mã số theo quy định của tiêu chuẩn UN M.49, ví dụ:
"DE"
cho Đức hoặc"002"
cho Châu Phi.Khai báo
Objective-C
@property (nonatomic, readonly, nullable) NSString *regionSubtag;
-
Thay vào đó, hãy sử dụng
from(languageTag:)
.Khai báo
Objective-C
- (nonnull instancetype)init;
-
Trả về giá trị nhận dạng mô hình phù hợp nhất với ngôn ngữ, tập lệnh (nếu bất kỳ) và khu vực (nếu có) được mã hoá theo định dạng
languageTag
của BCP 47.Quá trình so khớp là nỗ lực tối đa, tức là quá trình này trả về giá trị nhận dạng mô hình phù hợp nhất với
languageTag
được cung cấp bằng cách sử dụng suy nghiệm sau:- Nếu không tìm thấy giá trị nhận dạng mô hình cho thẻ phụ ngôn ngữ được yêu cầu, nhưng thẻ sau là của ngôn ngữ macro được hỗ trợ, so khớp với ngôn ngữ vĩ mô, ví dụ:
"arb"
(Chuẩn) Tiếng Ả Rập) sẽ khớp với"ar"
(Tiếng Ả Rập).- Nếu không có tập lệnh nào được cung cấp và không có tập lệnh nào được ngầm ẩn cho thẻ phụ ngôn ngữ được yêu cầu, hãy so khớp so với bất kỳ tập lệnh nào.
- Nếu thẻ phụ tập lệnh được cung cấp hoặc ngầm ẩn là một tập hợp con của tập lệnh được hỗ trợ, hãy so khớp với cả hai, ví dụ:
"zh-Hant"
(tiếng Trung, tiếng Hán phồn thể) sẽ đấu với"zh-Hani"
(Tiếng Trung, tiếng Hán).- Nếu không có thẻ phụ khu vực nào được chỉ định, hãy so khớp với bất kỳ khu vực nào, ưu tiên giá trị nhận dạng mô hình cũng không chỉ định khu vực, ví dụ:
"ro"
(tiếng Romania) sẽ đấu với"ro-RO"
(tiếng Romania, Romania).- Nếu thẻ phụ khu vực đã được chỉ định nhưng không so khớp được, hãy so khớp với các khu vực chứa khu vực cụ thể, ví dụ:
"fr-DZ"
(Pháp, Algeria) sẽ đấu với"fr-002"
(Pháp, Châu Phi).Nếu không tìm thấy giá trị nhận dạng mô hình, hãy trả về
nil
.Khai báo
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag error:(NSError *_Nullable *_Nullable)error;
Tham số
languageTag
Một thẻ ngôn ngữ BCP 47 của IETF biểu thị ngôn ngữ được yêu cầu.
error
Đối tượng thông báo lỗi không bắt buộc, sẽ được điền nếu không thể điền
languageTag
đã phân tích cú pháp.Giá trị trả về
mã nhận dạng mô hình khớp chính xác với thẻ ngôn ngữ được cung cấp hoặc giá trị gần đúng nhất hoặc
nil
nếu không tìm thấy giá trị nhận dạng mô hình phù hợp. Cũng được đặt thànhnil
nếu Không thể phân tích cú pháp thẻ ngôn ngữ. - Nếu không tìm thấy giá trị nhận dạng mô hình cho thẻ phụ ngôn ngữ được yêu cầu, nhưng thẻ sau là của ngôn ngữ macro được hỗ trợ, so khớp với ngôn ngữ vĩ mô, ví dụ:
-
Trả về giá trị nhận dạng mô hình khớp chính xác với
languageTag
đã cho.Khác với
from(LanguageTag:)
ở chỗ phương thức này không cố gắng phân tích cú pháplanguageTag
(và do đó không tạo ra lỗi) và chỉ trả về giá trị nhận dạng mô hình khớp vớilanguageTag
chính xác, nếu có.Khai báo
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;
Tham số
languageTag
Thẻ ngôn ngữ BCP 47 của IETF của mã nhận dạng mô hình được yêu cầu.
Giá trị trả về
DigitalInkRecognitionModelIdentifier
khớp chính xác vớilanguageTag
được cung cấp, hoặcnil
nếu không tìm thấy kết quả nào. -
Trả về tập hợp tất cả giá trị nhận dạng mô hình có sẵn.
Khai báo
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) allModelIdentifiers;
-
Trả về tập hợp giá trị nhận dạng mô hình hỗ trợ thẻ phụ ngôn ngữ cho sẵn.
Ví dụ: cho
"en"
, hàm này sẽ trả về một tập hợp giá trị nhận dạng mô hình chứaenUs
(tiếng Anh, Hoa Kỳ),enUk
(tiếng Anh, tiếng Anh),enKe
(tiếng Anh, tiếng Kenya), v.v.Nếu không tìm thấy giá trị nhận dạng mô hình nào hỗ trợ thẻ phụ ngôn ngữ thì hệ thống sẽ trả về một nhóm trống.
Khai báo
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;
Tham số
languageSubtag
Mã ngôn ngữ gồm 2 hoặc 3 chữ cái theo tiêu chuẩn ISO 639, ví dụ:
"en"
cho tiếng Anh.Giá trị trả về
Tập hợp giá trị nhận dạng mô hình hỗ trợ
languageSubtag
được cung cấp có thể trống. -
Trả về tập hợp giá trị nhận dạng mô hình hỗ trợ thẻ phụ của tập lệnh nhất định.
Ví dụ: cho
"Latn"
, hàm này sẽ trả về một tập hợp giá trị nhận dạng mô hình chứaenUs
(tiếng Anh, Hoa Kỳ),frFr
(tiếng Pháp, Pháp),guLatn
(tiếng Gujarat, chữ Latinh), v.v.Hàm này cũng trả về giá trị nhận dạng mô hình hỗ trợ tập mẹ của tập lệnh đã cho thẻ phụ, ví dụ: đối với
Hant
(tiếng Hán, biến thể Phồn thể), hàm này sẽ trả vềzh-Hani
vìHant
là tập con củaHani
(Han, cả Truyền thống và Biến thể đơn giản).Nếu không tìm thấy giá trị nhận dạng mô hình nào hỗ trợ thẻ phụ của tập lệnh thì phương thức sẽ trả về một tập trống.
Khai báo
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;
Tham số
scriptSubtag
Mã tiêu chuẩn ISO 15924 gồm bốn chữ cái, ví dụ:
"Latn"
cho chữ Latinh hoặc"Arab"
cho chữ Ả Rập.Giá trị trả về
Tập hợp giá trị nhận dạng mô hình hỗ trợ
scriptSubtag
được cung cấp có thể trống. -
Trả về tập hợp giá trị nhận dạng mô hình cụ thể cho thẻ phụ khu vực nhất định.
Ví dụ: đối với
"CH"
, hàm này sẽ trả về một tập hợp giá trị nhận dạng mô hình chứadeCh
(tiếng Đức, Thuỵ Sĩ),frCh
(tiếng Pháp, Thuỵ Sĩ),itCh
(tiếng Ý, Thuỵ Sĩ) vàrmCh
(tiếng Romansh, Thuỵ Sĩ).Hàm này cũng trả về giá trị nhận dạng mô hình cụ thể cho những khu vực có chứa giá trị nhận dạng thẻ phụ khu vực hoặc nằm trong thẻ phụ khu vực nhất định, ví dụ: tìm kiếm
DZ
(Algeria) sẽ cho ra kết quả bao gồm mô hình ghi nhậnfr-002
(tiếng Pháp, Châu Phi), và ngược lại.Nếu không tìm thấy giá trị nhận dạng mô hình hỗ trợ thẻ phụ khu vực thì hệ thống sẽ trả về một tập rỗng.
Khai báo
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;
Tham số
regionSubtag
Mã vùng tiêu chuẩn gồm hai chữ cái theo ISO 3166-1 Alpha 2 hoặc một trong mã số theo quy định của tiêu chuẩn UN M.49, ví dụ:
"DE"
cho Đức hoặc"002"
cho Châu Phi.Giá trị trả về
Tập hợp giá trị nhận dạng mô hình cụ thể cho
regionSubtag
được cung cấp, có thể là trống.