MLKDigitalInkRecognitionModelIdentifier
@interface MLKDigitalInkRecognitionModelIdentifier : NSObject
แสดงโมเดลการจดจำหมึกดิจิทัลสำหรับภาษา สคริปต์ และตัวแปรระดับภูมิภาค (ไม่บังคับ)
-
แท็กภาษาที่สอดคล้องกัน BCP 47 สำหรับโมเดลนี้
คำประกาศ
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageTag;
-
แท็กย่อยภาษา เช่น รหัสภาษา ISO 639 แบบ 2 หรือ 3 ตัวอักษรสำหรับโมเดลการจดจำนี้ เช่น
"en"
สำหรับภาษาอังกฤษคำประกาศ
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
-
แท็กย่อยของสคริปต์ เช่น รหัสมาตรฐาน ISO 15924 จำนวน 4 ตัวอักษรของสคริปต์ที่ใช้ในโมเดลการจดจำนี้ เช่น
"Latn"
สำหรับสคริปต์ละติน หรือ"Arab"
สำหรับสคริปต์อาหรับคำประกาศ
Objective-C
@property (nonatomic, readonly, nullable) NSString *scriptSubtag;
-
แท็กย่อยภูมิภาค เช่น รหัสภูมิภาคมาตรฐาน ISO 3166-1 Alpha 2 แบบ 2 ตัวอักษร หรือชุดรหัสตัวเลขที่กำหนดโดยมาตรฐาน UN M.49 เช่น
"DE"
สำหรับเยอรมนี หรือ"002"
สำหรับแอฟริกาคำประกาศ
Objective-C
@property (nonatomic, readonly, nullable) NSString *regionSubtag;
-
โปรดใช้
from(languageTag:)
แทนคำประกาศ
Objective-C
- (nonnull instancetype)init;
-
แสดงผลตัวระบุโมเดลที่ตรงกับภาษา สคริปต์ (หากมี) และภูมิภาค (หากมี) ซึ่งเข้ารหัสในรูปแบบ
languageTag
ในรูปแบบ BCP 47 มากที่สุดการจับคู่เป็นวิธีที่ดีที่สุด กล่าวคือ จะแสดงตัวระบุโมเดลที่ตรงกับ
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
หากแยกวิเคราะห์แท็กภาษาไม่ได้ - หากไม่พบตัวระบุโมเดลสำหรับแท็กย่อยของภาษาที่ขอ แต่ตัวระบุหลังเป็นส่วนหนึ่งของภาษามาโครที่รองรับ ให้จับคู่กับภาษามาโคร เช่น
-
แสดงผลตัวระบุโมเดลที่ตรงกับ
languageTag
ที่ระบุทุกประการแตกต่างจาก
from(LanguageTag:)
ตรงที่ไม่ได้พยายามแยกวิเคราะห์languageTag
(จึงไม่ทำให้เกิดข้อผิดพลาด) และจะแสดงผลตัวระบุโมเดลที่ตรงกับlanguageTag
ทุกประการ (หากมี)คำประกาศ
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;
พารามิเตอร์
languageTag
แท็กภาษา IETF BCP 47 ของตัวระบุโมเดลที่ขอ
ผลลัพธ์
DigitalInkRecognitionModelIdentifier
ตรงกับlanguageTag
ที่ระบุทุกประการ หรือnil
หากไม่พบเลย -
แสดงชุดตัวระบุโมเดลที่มีอยู่ทั้งหมด
คำประกาศ
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) allModelIdentifiers;
-
แสดงผลชุดตัวระบุโมเดลที่รองรับแท็กย่อยของภาษาที่ระบุ
เช่น สำหรับ
"en"
ผลลัพธ์นี้จะแสดงชุดตัวระบุโมเดลที่มีenUs
(อังกฤษ สหรัฐอเมริกา)enUk
(อังกฤษ สหราชอาณาจักร)enKe
(อังกฤษ เคนยา) ฯลฯหากไม่พบตัวระบุโมเดลที่รองรับแท็กย่อยของภาษา ระบบจะแสดงผลชุดว่าง
คำประกาศ
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;
พารามิเตอร์
languageSubtag
รหัสภาษา ISO 639 แบบ 2 หรือ 3 ตัวอักษร เช่น
"en"
สำหรับภาษาอังกฤษผลลัพธ์
ชุดตัวระบุโมเดลที่รองรับ
languageSubtag
ที่ระบุอาจว่างเปล่า -
แสดงผลชุดตัวระบุโมเดลที่รองรับแท็กย่อยของสคริปต์ที่ระบุ
เช่น สำหรับ
"Latn"
ผลลัพธ์นี้จะแสดงชุดตัวระบุโมเดลที่มีenUs
(อังกฤษ สหรัฐอเมริกา)frFr
(ฝรั่งเศส ฝรั่งเศส)guLatn
(คุชราต อักษรละติน) เป็นต้นฟังก์ชันนี้ยังแสดงผลตัวระบุโมเดลที่รองรับชุดพิเศษของแท็กย่อยสคริปต์ที่ระบุ เช่น สำหรับ
Hant
(รูปแบบ Han, แบบดั้งเดิม) ฟังก์ชันนี้จะแสดงผลโมเดลการจดจำzh-Hani
เนื่องจากHant
เป็นชุดย่อยของHani
(Han ทั้งรูปแบบดั้งเดิมและตัวย่อ)หากไม่พบตัวระบุโมเดลที่รองรับแท็กย่อยของสคริปต์ ระบบจะแสดงผลชุดที่ว่างเปล่า
คำประกาศ
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;
พารามิเตอร์
scriptSubtag
รหัสมาตรฐาน ISO 15924 แบบ 4 ตัวอักษร เช่น
"Latn"
สำหรับอักษรละตินหรือ"Arab"
สำหรับอักษรอาหรับผลลัพธ์
ชุดตัวระบุโมเดลที่รองรับ
scriptSubtag
ที่ระบุอาจว่างเปล่า -
แสดงผลชุดตัวระบุรูปแบบที่เฉพาะเจาะจงสำหรับแท็กย่อยของภูมิภาคที่ระบุ
เช่น สำหรับ
"CH"
คอลัมน์นี้จะแสดงชุดตัวระบุโมเดลที่มีdeCh
(เยอรมัน สวิตเซอร์แลนด์)frCh
(ฝรั่งเศส สวิตเซอร์แลนด์)itCh
(อิตาลี สวิตเซอร์แลนด์) และrmCh
(โรมาเนีย สวิตเซอร์แลนด์)ฟังก์ชันนี้ยังแสดงผลตัวระบุโมเดลเฉพาะสำหรับภูมิภาคที่มีแท็กย่อยภูมิภาคที่ระบุ หรืออยู่ในแท็กย่อยของภูมิภาคที่ระบุด้วย เช่น การค้นหา
DZ
(แอลจีเรีย) จะแสดงผลลัพธ์ที่มีโมเดลการจดจำfr-002
(ฝรั่งเศส แอฟริกา) และในทางกลับกันหากไม่พบตัวระบุโมเดลที่รองรับแท็กย่อยภูมิภาค ระบบจะแสดงผลชุดที่ว่างเปล่า
คำประกาศ
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;
พารามิเตอร์
regionSubtag
รหัสภูมิภาคมาตรฐาน ISO 3166-1 Alpha 2 แบบ 2 ตัวอักษร หรือรหัสตัวเลข 1 ตัวตามมาตรฐาน UN M.49 เช่น
"DE"
สำหรับเยอรมนี หรือ"002"
สำหรับแอฟริกาผลลัพธ์
ชุดตัวระบุโมเดลที่เฉพาะเจาะจงกับ
regionSubtag
ที่ระบุอาจว่างเปล่า