MLKitDigitalInkRecognition 架構參考資料

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

代表特定語言、腳本 (選填) 的數位墨水辨識模型 區域性子類。

  • 此模型的 BCP 47 符合語言標記。

    聲明

    Swift

    var languageTag: String { get }
  • 語言子標記,例如這個辨識模型的語言子標記 (2 個字母或 3 個字母的 ISO 639 語言代碼),例如 "en" 代表英文。

    聲明

    Swift

    var languageSubtag: String { get }
  • 指令碼子標記,也就是相關指令碼使用的四字母 ISO 15924 標準代碼 辨識模型,例如"Latn" (拉丁字母) 或 "Arab" (阿拉伯文指令碼)。

    聲明

    Swift

    var scriptSubtag: String? { get }
  • 區域子標記,例如雙字母 ISO 3166-1 Alpha 2 標準區碼 聯合國 M.49 標準定義的數值代碼,例如德國為 "DE",非洲為 "002"。

    聲明

    Swift

    var regionSubtag: String? { get }
  • 請改用 from(languageTag:)。

  • 傳回與語言、指令碼最相符的模型 ID (如果 以及區域 (如有),採 BCP 47 格式的 languageTag 編碼。

    系統會盡可能執行比對作業,也就是會盡可能傳回 符合下列經驗法則,最符合提供的 languageTag:

  • 如果要求的語言子標記找不到模型 ID,但後者找不到模型 ID, 部分支援的巨集語言,比對巨集語言,例如"arb" (標準) 阿拉伯文) 會比對 "ar" (阿拉伯文)。

  • 如未提供指令碼,且要求的語言子標記中未隱含指令碼,則比對相符 比對任何指令碼

  • 如果提供的子標記或隱含指令碼子標記是支援指令碼的一部分,請將 第二,例如"zh-Hant" (中文、繁體中文) 將與"zh-Hani"進行比對 (中文、漢字)。

  • 如未指定區域子標記,系統會優先比對任何區域,建議使用模型 ID 且未指定區域,例如"ro" (羅馬尼亞文) 將與"ro-RO" (羅馬尼亞文、 羅馬尼亞)。

  • 如果指定的區域子標記無法比對,請將該子標記與包含 指定區域 (例如"fr-DZ" (法文、阿爾及利亞) 將與"fr-002" (法文、 非洲)。

    如果找不到模型 ID,會傳回 nil。

  • 聲明

    Swift

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

    參數

    languageTag

    代表要求語言的 IETF BCP 47 語言標記。

    error

    選用的錯誤訊息物件;如果無法「languageTag」,系統會填入該物件 剖析。

    傳回值

    模型 ID 與提供的語言標記完全相符 或 nil (如果找不到適當的模型 ID)。如果nil 無法剖析 language 標記。

  • 傳回與指定 languageTag 完全相符的模型 ID。

    與 from(LanguageTag:) 的不同之處,在於它不會嘗試剖析 languageTag 且不會產生錯誤),且只會傳回符合 languageTag (如果有的話)。

    聲明

    Swift

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

    參數

    languageTag

    所要求模型 ID 的 IETF BCP 47 語言標記。

    傳回值

    與提供的 languageTag 完全相符的 DigitalInkRecognitionModelIdentifier,或 如果沒有找到,則設為 nil。

  • 傳回所有可用的模型 ID 組合。

    聲明

    Swift

    class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>
  • 傳回支援指定語言子標記的模型 ID 組合。

    例如:如果是 "en",則會傳回一組包含 enUs 的模型 ID (英文、美國)、enUk (英文、英國)、enKe (英文、肯亞) 等。

    如果找不到支援語言子標記的模型 ID,系統會傳回空白集合。

    聲明

    Swift

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

    參數

    languageSubtag

    2 或 3 個英文字母組成的 ISO 639 語言代碼,例如"en" 代表英文。

    傳回值

    支援所提供 languageSubtag 的模型 ID 可以是空白。

  • 傳回支援指定指令碼子標記的模型 ID 組合。

    例如:如果是 "Latn",則會傳回一組模型 ID,其中包含 enUs (英文、美國)、frFr (法文、法國)、guLatn (古吉拉特文、拉丁字母) 等。

    這個函式也會傳回模型 ID,可支援指定指令碼的超集 子標記,例如如果是 Hant (漢字、傳統變體),這個函式會傳回 zh-Hani 辨識模型,因為 Hant 是 Hani 的子集 (Han,傳統和 簡化版變化版本)。

    如果找不到支援指令碼子標記的模型 ID,則會傳回空白的集合。

    聲明

    Swift

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

    參數

    scriptSubtag

    四字母 ISO 15924 標準代碼,例如"Latn" (拉丁字母) 或 "Arab" 為阿拉伯文指令碼。

    傳回值

    支援所提供 scriptSubtag 的模型 ID 可以是空白。

  • 傳回特定區域子標記專屬的模型 ID 組合。

    例如:如果是 "CH",則會傳回一組包含 deCh 的模型 ID (德文、 瑞士)、frCh (法文、瑞士)、itCh (義大利文、瑞士) 和 rmCh (羅馬許 瑞士)。

    這個函式也會傳回特定區域的模型 ID,其中包含 區域子標記,或是由特定區域子標記包含,例如:正在搜尋「DZ」(阿爾及利亞) 會產生包含 fr-002 (法文、非洲) 辨識模型的結果 反之亦然

    如果找不到支援區域子標記的模型 ID,系統會傳回空白集合。

    聲明

    Swift

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

    參數

    regionSubtag

    雙字母 ISO 3166-1 Alpha 2 標準區碼,或是 聯合國 M.49 標準定義的數值代碼,例如德國為 "DE",非洲為 "002"。

    傳回值

    您提供的 regionSubtag 專屬的模型 ID 組可能是 並將空無一物。