MLKDigitalInkRecognitionModelIdentifier
@interface MLKDigitalInkRecognitionModelIdentifier : NSObject
Mewakili model pengenalan tinta digital khusus untuk bahasa, skrip, dan, opsional untuk varian regional.
-
Tag bahasa yang sesuai BCP 47 untuk model ini.
Pernyataan
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageTag;
-
Subtag bahasa, yaitu kode bahasa ISO 639 2 atau 3 huruf untuk model pengenalan ini, misalnya,
"en"
untuk bahasa Inggris.Pernyataan
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
-
Subtag skrip, yaitu kode standar ISO 15924 empat huruf dari skrip yang digunakan dalam model pengenalan ini, misalnya,
"Latn"
untuk skrip Latin atau"Arab"
untuk skrip Arab.Pernyataan
Objective-C
@property (nonatomic, readonly, nullable) NSString *scriptSubtag;
-
Subtag wilayah, yaitu kode wilayah standar ISO 3166-1 Alpha 2 dua huruf atau kumpulan kode numerik yang ditentukan oleh standar PBB M.49, misalnya
"DE"
untuk Jerman atau"002"
untuk Afrika.Pernyataan
Objective-C
@property (nonatomic, readonly, nullable) NSString *regionSubtag;
-
Sebagai gantinya, gunakan
from(languageTag:)
.Pernyataan
Objective-C
- (nonnull instancetype)init;
-
Menampilkan ID model yang paling cocok dengan bahasa, skrip (jika ada), dan wilayah (jika ada) yang dienkode dalam
languageTag
berformat BCP 47.Pencocokan merupakan upaya terbaik, yaitu menampilkan ID model yang paling cocok dengan
languageTag
yang disediakan menggunakan heuristik berikut:- Jika tidak ada ID model yang dapat ditemukan untuk subtag bahasa yang diminta, tetapi subtag bahasa kedua adalah bagian dari bahasa makro yang didukung, kecocokan dengan bahasa makro, misalnya,
"arb"
(Bahasa Arab Standar) akan cocok dengan"ar"
(Arab).- Jika tidak ada skrip yang disediakan, dan tidak ada skrip yang implisit untuk subtag bahasa yang diminta, cocokkan dengan skrip apa pun.
- Jika subtag skrip yang diberikan atau implisit adalah subset dari skrip yang didukung, cocokkan juga dengan skrip yang terakhir. Misalnya,
"zh-Hant"
(China, Han Tradisional) akan cocok dengan"zh-Hani"
(China, Han).- Jika tidak ada subtag wilayah yang ditentukan, cocokkan dengan wilayah mana pun, memilih ID model yang juga tidak menentukan wilayah, misalnya,
"ro"
(Rumania) akan cocok dengan"ro-RO"
(Rumania, Rumania).- Jika subtag wilayah ditentukan, tetapi tidak dapat dicocokkan, pencocokan dengan wilayah yang berisi wilayah yang ditentukan, misalnya,
"fr-DZ"
(Prancis, Aljazair) akan cocok dengan"fr-002"
(Prancis, Afrika).Jika tidak ada ID model yang dapat ditemukan, tampilkan
nil
.Pernyataan
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag error:(NSError *_Nullable *_Nullable)error;
Parameter
languageTag
Tag bahasa IETF BCP 47 yang mewakili bahasa yang diminta.
error
Objek pesan error opsional, akan diisi jika
languageTag
tidak dapat diurai.Nilai yang Ditampilkan
ID model yang sama persis dengan tag bahasa yang diberikan, atau pencocokan hasil terdekat terbaik, atau
nil
jika tidak ada ID model yang sesuai yang dapat ditemukan. Tetapkan juga kenil
jika tag bahasa tidak dapat diurai. - Jika tidak ada ID model yang dapat ditemukan untuk subtag bahasa yang diminta, tetapi subtag bahasa kedua adalah bagian dari bahasa makro yang didukung, kecocokan dengan bahasa makro, misalnya,
-
Menampilkan ID model yang sama persis dengan
languageTag
yang diberikan.Berbeda dengan
from(LanguageTag:)
karena tidak mencoba mengurailanguageTag
(sehingga tidak menghasilkan error), dan hanya menampilkan ID model yang sama persis denganlanguageTag
, jika ada.Pernyataan
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;
Parameter
languageTag
Tag bahasa IETF BCP 47 dari ID model yang diminta.
Nilai yang Ditampilkan
DigitalInkRecognitionModelIdentifier
yang sama persis denganlanguageTag
yang diberikan, ataunil
jika tidak ada yang ditemukan. -
Menampilkan kumpulan semua ID model yang tersedia.
Pernyataan
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) allModelIdentifiers;
-
Menampilkan kumpulan ID model yang mendukung subtag bahasa yang ditentukan.
Misalnya, untuk
"en"
, ini akan menampilkan kumpulan ID model yang berisienUs
(Inggris, Amerika Serikat),enUk
(Inggris, Inggris Raya),enKe
(Inggris, Kenya), dll.Jika tidak ada ID model yang mendukung subtag bahasa yang dapat ditemukan, tampilkan kumpulan kosong.
Pernyataan
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;
Parameter
languageSubtag
Kode bahasa ISO 639 2 atau 3 huruf, misalnya
"en"
untuk bahasa Inggris.Nilai yang Ditampilkan
Kumpulan ID model yang mendukung
languageSubtag
yang diberikan mungkin kosong. -
Menampilkan kumpulan ID model yang mendukung subtag skrip yang diberikan.
Misalnya, untuk
"Latn"
, ini akan menampilkan kumpulan ID model yang berisienUs
(Inggris, Amerika Serikat),frFr
(Prancis, Prancis),guLatn
(Gujarati, skrip Latin), dll.Fungsi ini juga menampilkan ID model yang mendukung superset dari subtag skrip yang ditentukan, misalnya, untuk
Hant
(varian Han, Tradisional), fungsi ini akan menampilkan model pengenalanzh-Hani
karenaHant
adalah subset dariHani
(Han, baik varian Tradisional maupun yang Disederhanakan).Jika tidak ada pengidentifikasi model yang mendukung subtag skrip yang dapat ditemukan, tampilkan kumpulan kosong.
Pernyataan
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;
Parameter
scriptSubtag
Kode standar ISO 15924 empat huruf, misalnya,
"Latn"
untuk skrip Latin atau"Arab"
untuk skrip Arab.Nilai yang Ditampilkan
Kumpulan ID model yang mendukung
scriptSubtag
yang diberikan mungkin kosong. -
Menampilkan kumpulan ID model yang spesifik untuk subtag wilayah yang ditentukan.
Misalnya, untuk
"CH"
, ini akan menampilkan kumpulan ID model yang berisideCh
(Jerman, Swiss),frCh
(Prancis, Swiss),itCh
(Italia, Swiss), danrmCh
(Romansh, Swiss).Fungsi ini juga menampilkan ID model khusus untuk wilayah yang berisi subtag wilayah yang ditentukan, atau yang terdapat dalam subtag wilayah yang ditentukan, misalnya, menelusuri
DZ
(Aljazair) akan memberikan hasil yang menyertakan model pengenalanfr-002
(Prancis, Afrika), dan sebaliknya.Jika tidak ada ID model yang mendukung subtag wilayah yang dapat ditemukan, tampilkan kumpulan kosong.
Pernyataan
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;
Parameter
regionSubtag
Kode wilayah standar ISO 3166-1 Alpha 2 dua huruf atau salah satu kode numerik yang ditentukan oleh standar UN M.49, misalnya,
"DE"
untuk Jerman atau"002"
untuk Afrika.Nilai yang Ditampilkan
Kumpulan ID model yang khusus untuk
regionSubtag
yang disediakan mungkin kosong.