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


                    
                    
                    languageTag

Thẻ ngôn ngữ tuân thủ BCP 47 cho mô hình này.

Khai báo

Swift

var languageTag: String { get }


                    
                    
                    languageSubtag

Thẻ phụ ngôn ngữ, tức là 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

Swift

var languageSubtag: String { get }


                    
                    
                    scriptSubtag

Thẻ phụ của tập lệnh, tức là mã tiêu chuẩn ISO 15924 gồm bốn chữ cái của tập lệnh được sử dụng trong mô hình nhận dạng này, ví dụ: "Latn" cho hệ thống chữ viết Latinh hoặc "Arab" cho hệ thống chữ viết Ả Rập.

Khai báo

Swift

var scriptSubtag: String? { get }


                    
                    
                    regionSubtag

Thẻ phụ khu vực, tức là mã vùng tiêu chuẩn ISO 3166-1 Alpha 2 gồm hai chữ cái hoặc bộ mã số được xác định theo tiêu chuẩn M.49 của Liên Hợp Quốc, ví dụ: "DE" cho Đức hoặc "002" cho Châu Phi.

Khai báo

Swift

var regionSubtag: String? { get }


                    
                    
                    -init

Thay vào đó, hãy sử dụng from(languageTag:).


                    
                    
                    from(languageTag:)

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 có) và khu vực (nếu có) được mã hoá theo languageTag được định dạng BCP 47.

Việc so khớp là cách hiệu quả nhất, tức là sẽ trả về giá trị nhận dạng mô hình phù hợp nhất với languageTag đã cung cấp bằng cách sử dụng các phương pháp phỏng đoán 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 mã sau là một phần của ngôn ngữ macro được hỗ trợ, hãy khớp với ngôn ngữ macro, ví dụ: "arb" (Tiếng Ả Rập chuẩn) 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 định cho thẻ phụ ngôn ngữ được yêu cầu, hãy so khớp với bất kỳ tập lệnh nào.

Nếu thẻ phụ của 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 cả thẻ phụ, ví dụ: "zh-Hant" (tiếng Trung, chữ Hán phồn thể) sẽ khớp với "zh-Hani" (tiếng Trung, chữ Hán).

Nếu bạn không chỉ định thẻ phụ khu vực nào, hãy so khớp với khu vực bất kỳ, ư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ẽ khớp với "ro-RO" (tiếng Romania, Romania).

Nếu bạn đã chỉ định thẻ phụ khu vực nhưng không so khớp được, hãy so khớp với các khu vực có chứa khu vực đã chỉ định. Ví dụ: "fr-DZ" (tiếng Pháp, Algeria) sẽ so khớp với "fr-002" (tiếng 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

Swift

class func from(languageTag: String) throws -> DigitalInkRecognitionModelIdentifier

Các tham số

`languageTag`	Một thẻ ngôn ngữ BCP 47 của IETF đại diện cho 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 sẵn nếu không thể phân tích cú pháp `languageTag`.

Giá trị trả về

giá trị 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 kết quả khớp 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 thích hợp. Đồng thời, đặt thành nil nếu không thể phân tích cú pháp thẻ ngôn ngữ.


                    
                    
                    init(forLanguageTag:)

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ỗ mã này không cố gắng phân tích cú pháp languageTag (nên không tạo ra lỗi) và chỉ trả về chính xác giá trị nhận dạng mô hình khớp với languageTag nếu có.

Khai báo

Swift

/*not inherited*/ init?(forLanguageTag languageTag: String)

Các tham số


                                languageTag

Thẻ ngôn ngữ IETF BCP 47 của giá trị 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 đã cung cấp hoặc nil nếu không tìm thấy mã nào.


                    
                    
                    allModelIdentifiers()

Trả về tập hợp tất cả các giá trị nhận dạng mô hình hiện có.

Khai báo

Swift

class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>


                    
                    
                    modelIdentifiers(forLanguageSubtag:)

Trả về tập hợp giá trị nhận dạng mô hình có hỗ trợ thẻ phụ ngôn ngữ đã cho.

Ví dụ: đối với "en", thao tác này sẽ trả về một tập hợp các giá trị nhận dạng mô hình chứa enUs (tiếng Anh, Hoa Kỳ), enUk (tiếng Anh, Vương quốc Anh), enKe (tiếng Anh, Kenya), v.v.

Nếu không tìm thấy giá trị nhận dạng mô hình hỗ trợ thẻ phụ ngôn ngữ, hãy trả về một tập dữ liệu trống.

Khai báo

Swift

class func modelIdentifiers(forLanguageSubtag languageSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>

Các tham số


                                languageSubtag

Mã ngôn ngữ gồm 2 hoặc 3 chữ cái theo ISO 639, ví dụ: "en" cho tiếng Anh.

Giá trị trả về

Có thể để trống một tập hợp giá trị nhận dạng mô hình hỗ trợ languageSubtag được cung cấp.


                    
                    
                    modelIdentifiers(forScriptSubtag:)

Trả về tập hợp giá trị nhận dạng mô hình có hỗ trợ thẻ phụ tập lệnh đã cho.

Ví dụ: đối với "Latn", thao tác này sẽ trả về một tập hợp các 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ề các giá trị nhận dạng mô hình hỗ trợ tập mẹ của thẻ phụ tập lệnh cụ thể, ví dụ: đối với Hant (biến thể Han, biến thể Phồn thể), hàm này sẽ trả về các mô hình nhận dạng zh-Hani vì Hant là một tập hợp con của Hani (Han, cả biến thể Phồn thể và biến thể Giản thể).

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, hãy trả về một tập hợp trống.

Khai báo

Swift

class func modelIdentifiers(forScriptSubtag scriptSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>

Các tham số


                                scriptSubtag

Mã tiêu chuẩn ISO 15924 gồm bốn chữ cái, ví dụ: "Latn" cho hệ thống chữ viết Latinh hoặc "Arab" cho hệ chữ viết Ả Rập.

Giá trị trả về

Có thể để trống một tập hợp giá trị nhận dạng mô hình hỗ trợ scriptSubtag được cung cấp.


                    
                    
                    modelIdentifiers(forRegionSubtag:)

Trả về tập hợp giá trị nhận dạng mô hình dành riêng cho thẻ phụ khu vực nhất định.

Ví dụ: đối với "CH", thao tác này sẽ trả về một tập hợp các 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 (Romansh, Thuỵ Sĩ).

Hàm này cũng trả về giá trị nhận dạng mô hình dành riêng cho những khu vực có chứa thẻ phụ khu vực nhất định hoặc thuộc một thẻ phụ khu vực nhất định. Ví dụ: khi tìm kiếm DZ (Algeria) sẽ cho ra kết quả bao gồm mô hình nhận dạng 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, trả về một tập dữ liệu trống.

Khai báo

Swift

class func modelIdentifiers(forRegionSubtag regionSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>

Các tham số


                                regionSubtag

Mã vùng theo tiêu chuẩn ISO 3166-1 Alpha 2 gồm hai chữ cái hoặc một trong các mã số được xác định theo tiêu chuẩn M.49 của Liên Hợp Quốc, ví dụ: "DE" cho Đức hoặc "002" cho Châu Phi.

Giá trị trả về

Có thể để trống một tập hợp giá trị nhận dạng mô hình dành riêng cho regionSubtag được cung cấp.