Tài liệu tham khảo khung MLKitDigitalInkRecognition

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ành nil nếu Không thể phân tích cú pháp thẻ ngôn ngữ.

  • 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áp languageTag (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ới languageTag 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ới languageTag được cung cấp, hoặc nil 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ứa enUs (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ứa enUs (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-HaniHant là tập con của Hani (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ứa deCh (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ận fr-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.