DigitalInkRecognitionModelIdentifier
class DigitalInkRecognitionModelIdentifier : NSObject
言語、文字、および必要に応じて地域のバリエーションに固有なデジタルインク認識モデルを表します。
-
このモデルの BCP 47 準拠言語タグ。
宣言
Swift
var languageTag: String { get }
-
言語サブタグ。この認識モデルの 2 文字または 3 文字の ISO 639 言語コード(例: 英語の場合は
"en"
)。宣言
Swift
var languageSubtag: String { get }
-
スクリプト サブタグ。この認識モデルで使用されるスクリプトの 4 文字の ISO 15924 標準コード。たとえば、ラテン文字の場合は
"Latn"
、アラビア文字の場合は"Arab"
です。宣言
Swift
var scriptSubtag: String? { get }
-
地域のサブタグ。2 文字の ISO 3166-1 Alpha 2 標準地域コード、または UN M.49 標準で定義された数値コードのセット(例: ドイツは
"DE"
、アフリカは"002"
)。宣言
Swift
var regionSubtag: String? { get }
-
from(languageTag:)
を代わりに使用してください。 -
BCP 47 形式の
languageTag
でエンコードされた言語、スクリプト(存在する場合)、地域(存在する場合)に最も適合するモデル ID を返します。このマッチングはベスト エフォートです。すなわち、次のヒューリスティックを使用して、指定された
languageTag
に最も適合するモデル ID を返します。- リクエストされた言語のサブタグでモデル識別子が見つからなくても、後者がサポートされているマクロ言語の一部である場合は、マクロ言語と一致させます。たとえば、
"arb"
(標準アラビア語)は"ar"
(アラビア語)と一致します。- スクリプトが指定されず、リクエストされた言語のサブタグに対して暗黙的なスクリプトが設定されていない場合は、任意のスクリプトと照合します。
- 提供された、または暗黙的な script サブタグがサポートされているスクリプトのサブセットである場合は、後者にも一致します。たとえば、
"zh-Hant"
(中国語、繁体字のハングル)は"zh-Hani"
(中国語、中国語)と一致します。- region サブタグが指定されていない場合は、どの地域にも照合し、地域を指定していないモデル ID を優先します。たとえば、
"ro"
(ルーマニア語)は"ro-RO"
(ルーマニア語、ルーマニア)と一致します。- region サブタグを指定していても、一致しない場合は、指定した地域を含む地域が照合されます。たとえば、
"fr-DZ"
(フランス語、アルジェリア)は"fr-002"
(フランス語、アフリカ)と照合されます。モデル ID が見つからない場合は、
nil
を返します。宣言
Swift
class func from(languageTag: String) throws -> DigitalInkRecognitionModelIdentifier
パラメータ
languageTag
リクエストされた言語を表す IETF BCP 47 言語タグ。
error
省略可能なエラー メッセージ オブジェクト。
languageTag
を解析できない場合に入力されます。戻り値
指定された言語タグと完全に一致するモデル ID、または最も近い近似値。適切なモデル ID が見つからない場合は
nil
。言語タグを解析できなかった場合もnil
に設定されます。 - リクエストされた言語のサブタグでモデル識別子が見つからなくても、後者がサポートされているマクロ言語の一部である場合は、マクロ言語と一致させます。たとえば、
-
指定された
languageTag
と完全に一致するモデル ID を返します。from(LanguageTag:)
と異なる点は、languageTag
の解析を試行せず(したがってエラーを生成しない)、languageTag
と完全に一致するモデル ID(存在する場合)のみを返す点です。宣言
Swift
/*not inherited*/ init?(forLanguageTag languageTag: String)
パラメータ
languageTag
リクエストされたモデル識別子の IETF BCP 47 言語タグ。
戻り値
指定された
languageTag
と完全に一致するDigitalInkRecognitionModelIdentifier
。見つからなかった場合はnil
。 -
使用可能なすべてのモデル ID のセットを返します。
宣言
Swift
class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>
-
指定された言語サブタグをサポートするモデル ID のセットを返します。
たとえば
"en"
の場合、enUs
(英語、米国)、enUk
(英語、英国)、enKe
(英語、ケニア)などを含むモデル ID のセットが返されます。言語サブタグをサポートするモデル ID が見つからない場合は、空のセットが返されます。
宣言
Swift
class func modelIdentifiers(forLanguageSubtag languageSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>
パラメータ
languageSubtag
2 文字または 3 文字の ISO 639 言語コード(例: 英語の場合は
"en"
)。戻り値
指定された
languageSubtag
をサポートするモデル ID のセットは、空でもかまいません。 -
指定された script サブタグをサポートするモデル ID のセットを返します。
たとえば
"Latn"
の場合、enUs
(英語、米国)、frFr
(フランス語、フランス)、guLatn
(グジャラート語、ラテン文字)などを含むモデル ID のセットが返されます。この関数は、指定された script サブタグのスーパーセットをサポートするモデル ID も返します。たとえば、
Hant
(Han、従来型バリアント)の場合は、Hant
がHani
のサブセットであるため、zh-Hani
認識モデルを返します(Han は従来のバリアントと簡易バリアントの両方)。script サブタグをサポートするモデル ID が見つからない場合は、空のセットが返されます。
宣言
Swift
class func modelIdentifiers(forScriptSubtag scriptSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>
パラメータ
scriptSubtag
4 文字の ISO 15924 標準コード。たとえば、ラテン文字の場合は
"Latn"
、アラビア文字の場合は"Arab"
です。戻り値
指定された
scriptSubtag
をサポートするモデル ID のセットは、空でもかまいません。 -
指定された region サブタグに固有のモデル ID のセットを返します。
たとえば
"CH"
の場合、deCh
(ドイツ語、スイス)、frCh
(フランス語、スイス)、itCh
(イタリア語、スイス)、rmCh
(ロマンシュ、スイス)を含むモデル ID のセットが返されます。この関数は、指定した region サブタグを含む地域、または指定された region サブタグに含まれる地域に固有のモデル ID を返します。たとえば、
DZ
(アルジェリア)を検索するとfr-002
(フランス語、アフリカ)認識モデルを含む結果が生成され、その逆も同様です。リージョン サブタグをサポートするモデル ID が見つからない場合は、空のセットが返されます。
宣言
Swift
class func modelIdentifiers(forRegionSubtag regionSubtag: String) -> Set<DigitalInkRecognitionModelIdentifier>
パラメータ
regionSubtag
2 文字の ISO 3166-1 Alpha 2 標準地域コード、または UN M.49 規格で定義されている数値コード(たとえば、ドイツは
"DE"
、アフリカは"002"
)。戻り値
指定された
regionSubtag
に固有のモデル ID のセットは、空にすることもできます。