סימוכין למסגרת של MLKitDigitalInkRecognition

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

מייצג מודל לזיהוי דיו דיגיטלי ספציפי לשפה, לסקריפט, ובאופן אופציונלי גם לווריאנט אזורי.

• languageTag

  תג השפה BCP 47 תואם למודל הזה.

  הצהרה

  Swift

  var languageTag: String { get }

• languageSubtag

  תג משנה של שפה, כלומר קוד השפה בן 2 או 3 אותיות לפי תקן ISO 639 למודל הזיהוי הזה. למשל, "en" לאנגלית.

  הצהרה

  Swift

  var languageSubtag: String { get }

• scriptSubtag

  תג משנה של סקריפט, כלומר הקוד בן ארבע אותיות לפי תקן ISO 15924 של הסקריפט שמשמש במודל הזיהוי הזה. למשל "Latn" לכתב לטיני או "Arab" לכתב ערבי.

  הצהרה

  Swift

  var scriptSubtag: String? { get }

• regionSubtag

  תג משנה של אזור, כלומר שתי אותיות של קודי אזור בתקן ISO 3166-1 Alpha 2, או קבוצת קודים מספריים שהוגדרה בתקן M.49 של האו"ם. למשל: "DE" לגרמניה או "002" לאפריקה.

  הצהרה

  Swift

  var regionSubtag: String? { get }

• -init

  במקומה צריך להשתמש במדיניות from(languageTag:).

• from(languageTag:)

  הפונקציה מחזירה את מזהה המודל המתאים ביותר לשפה, לסקריפט (אם יש) ולאזור (אם יש) שמקודדים ב-BCP 47 בפורמט languageTag.

  ההתאמה היא התוצאה הטובה ביותר, כלומר, היא תחזיר את מזהה המודל שמתאים בצורה הטובה ביותר ל-languageTag שסופק, באמצעות ההיוריסטיקה הבאה:

  אם לא נמצא מזהה מודל לתג המשנה של השפה המבוקש, אבל התג השני הוא חלק משפת מאקרו נתמכת, צריך לבצע התאמה מול שפת המאקרו. למשל: "arb" (ערבית רגילה) יתאים ל-"ar" (ערבית).

  אם לא סופק סקריפט, ואין סקריפט מרומז לתג המשנה של השפה המבוקש, יש לבצע התאמה לסקריפט כלשהו.

  אם תג המשנה של הסקריפט שסופק או המרומז הוא קבוצת משנה של סקריפט נתמך, עליך להתאים גם לתג השני. למשל, "zh-Hant" (סינית, האן מסורתית) יתאים ל-"zh-Hani" (סינית, האן).

  אם לא צוין תג משנה של אזור, יש לבצע התאמה כנגד אזור כלשהו.עדיף לבחור מזהי מודל שלא מציינים אזור. למשל, "ro" (רומנית) יתאים ל-"ro-RO" (רומנית, רומניה).

  אם צוין תג משנה של אזור, אבל לא תהיה לו התאמה, תתבצע התאמה כנגד אזורים שמכילים את האזור שצוין. למשל, "fr-DZ" (צרפתית, אלג'יריה) תשווה מול "fr-002" (צרפתית, אפריקה).

  אם לא נמצא מזהה מודל, הפונקציה מחזירה את הערך nil.

  הצהרה

  Swift

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

  פרמטרים

  languageTag	תג שפה IETF BCP 47 שמייצג את השפה המבוקשת.
  error	אובייקט אופציונלי של הודעת שגיאה, יאוכלס אם לא ניתן לנתח את languageTag.

  הערך המוחזר

  מזהה מודל שתואם במדויק לתג השפה שסופק, או להתאמה המשוערת הטובה ביותר, או nil אם לא נמצא מזהה מודל מתאים. מוגדר גם לערך nil אם לא ניתן לנתח את תג השפה.

• init(forLanguageTag:)

  הפונקציה מחזירה מזהה מודל שתואם בדיוק ל-languageTag הנתון.

  שונה מ-from(LanguageTag:) בכך שהוא לא מנסה לנתח את languageTag (ולכן לא יוצר שגיאות), ופשוט מחזיר את מזהה המודל שתואם ל-languageTag בדיוק, אם הוא קיים.

  הצהרה

  Swift

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

  פרמטרים

  languageTag

  תג השפה IETF BCP 47 של מזהה המודל המבוקש.

  הערך המוחזר

  DigitalInkRecognitionModelIdentifier שתואם במדויק ל-languageTag שצוין, או nil אם לא נמצא אף פריט.

• allModelIdentifiers()

  מחזירה את הקבוצה של כל מזהי המודלים הזמינים.

  הצהרה

  Swift

  class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>

• modelIdentifiers(forLanguageSubtag:)

  מחזירה את הקבוצה של מזהי המודל שתומכים בתג המשנה של השפה.

  למשל, אם מזינים "en", הפונקציה הזו תחזיר קבוצה של מזהי מודל שמכילים enUs (אנגלית, ארה"ב), enUk (אנגלית, בריטניה), enKe (אנגלית, קניה) וכו'.

  אם לא נמצאו מזהי מודלים שתומכים בתג המשנה של השפה, הפונקציה מחזירה קבוצה ריקה.

  הצהרה

  Swift

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

  פרמטרים

  languageSubtag

  קוד שפה של 2 או 3 אותיות לפי תקן ISO 639, למשל "en" לאנגלית.

  הערך המוחזר

  קבוצה של מזהי מודל שתומכים בפרמטר languageSubtag שצוין יכולה להיות ריקה.

• modelIdentifiers(forScriptSubtag:)

  מחזירה את הקבוצה של מזהי המודל שתומכים בתג המשנה הנתון של הסקריפט.

  למשל, עבור "Latn", הפונקציה הזו תחזיר קבוצה של מזהי מודל שמכילים enUs (אנגלית, ארה"ב), frFr (צרפתית, צרפת), guLatn (גוג'ראטית, כתב לטיני) וכו'.

  הפונקציה הזו מחזירה גם מזהי מודלים שתומכים בקבוצת-על של תג המשנה הנתון של הסקריפט. למשל, עבור Hant (גרסה מסורתית, Han), הפונקציה הזו תחזיר את המודלים לזיהוי zh-Hani, כי Hant הוא קבוצת משנה של Hani (גרסה מסורתית וגם גרסה פשוטה).

  אם לא ניתן למצוא מזהי מודל שתומכים בתג המשנה של הסקריפט, הפונקציה מחזירה קבוצה ריקה.

  הצהרה

  Swift

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

  פרמטרים

  scriptSubtag

  קוד סטנדרטי בן ארבע אותיות לפי תקן ISO 15924, למשל "Latn" לכתב לטיני או "Arab" לכתב ערבי.

  הערך המוחזר

  קבוצה של מזהי מודל שתומכים בפרמטר scriptSubtag שצוין יכולה להיות ריקה.

• modelIdentifiers(forRegionSubtag:)

  מחזירה את הקבוצה של מזהי המודל שהם ספציפיים לתג המשנה האזורי הנתון.

  לדוגמה, אם מזינים "CH", הפונקציה הזו תחזיר קבוצה של מזהי מודל שמכילים deCh (גרמנית, שווייץ), frCh (צרפתית, שווייץ), itCh (איטלקית, שווייץ) ו-rmCh (רומנית, שווייץ).

  הפונקציה הזו מחזירה גם מזהי מודל שספציפיים לאזורים שמכילים את תג המשנה לציון אזור מסוים או שכלולים בתג המשנה הזה של האזור. למשל, חיפוש של המילה DZ (אלג'יריה) יפיק תוצאות שכוללות את מודל הזיהוי של fr-002 (צרפתית, אפריקה), ולהיפך.

  אם לא ניתן למצוא מזהי מודלים שתומכים בתג המשנה של האזור, הפונקציה מחזירה קבוצה ריקה.

  הצהרה

  Swift

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

  פרמטרים

  regionSubtag

  קוד אזור בן שתי אותיות לפי תקן ISO 3166-1 Alpha 2, או אחד מהקודים המספריים שהוגדרו בתקן UN M.49, למשל "DE" לגרמניה או "002" לאפריקה.

  הערך המוחזר

  קבוצה של מזהי מודל ספציפיים ל-regionSubtag שצוינה יכולה להיות ריקה.