MLKitDigitalInkRecognition フレームワーク リファレンス

MLKDigitalInkRecognitionModelIdentifier

@interface MLKDigitalInkRecognitionModelIdentifier : NSObject

言語、文字、および必要に応じて地域のバリエーションに固有なデジタルインク認識モデルを表します。

• languageTag

  このモデルの BCP 47 準拠言語タグ。

  宣言

  Objective-C

  @property (nonatomic, readonly) NSString *_Nonnull languageTag;

• languageSubtag

  言語サブタグ。この認識モデルの 2 文字または 3 文字の ISO 639 言語コード（例: 英語の場合は "en"）。

  宣言

  Objective-C

  @property (nonatomic, readonly) NSString *_Nonnull languageSubtag;

• scriptSubtag

  スクリプト サブタグ。この認識モデルで使用されるスクリプトの 4 文字の ISO 15924 標準コード。たとえば、ラテン文字の場合は "Latn"、アラビア文字の場合は "Arab" です。

  宣言

  Objective-C

  @property (nonatomic, readonly, nullable) NSString *scriptSubtag;

• regionSubtag

  地域のサブタグ。2 文字の ISO 3166-1 Alpha 2 標準地域コード、または UN M.49 標準で定義された数値コードのセット（例: ドイツは "DE"、アフリカは "002"）。

  宣言

  Objective-C

  @property (nonatomic, readonly, nullable) NSString *regionSubtag;

• -init

  from(languageTag:) を代わりに使用してください。

  宣言

  Objective-C

  - (nonnull instancetype)init;

• +modelIdentifierFromLanguageTag:error:

  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 を返します。

  宣言

  Objective-C

  + (nullable MLKDigitalInkRecognitionModelIdentifier *)
      modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag
                               error:(NSError *_Nullable *_Nullable)error;

  パラメータ

  languageTag	リクエストされた言語を表す IETF BCP 47 言語タグ。
  error	省略可能なエラー メッセージ オブジェクト。languageTag を解析できない場合に入力されます。

  戻り値

  指定された言語タグと完全に一致するモデル ID、または最も近い近似値。適切なモデル ID が見つからない場合は nil。言語タグを解析できなかった場合も nil に設定されます。

• +modelIdentifierForLanguageTag:

  指定された languageTag と完全に一致するモデル ID を返します。

  from(LanguageTag:) と異なる点は、languageTag の解析を試行せず（したがってエラーを生成しない）、languageTag と完全に一致するモデル ID（存在する場合）のみを返す点です。

  宣言

  Objective-C

  + (nullable MLKDigitalInkRecognitionModelIdentifier *)
      modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;

  パラメータ

  languageTag

  リクエストされたモデル識別子の IETF BCP 47 言語タグ。

  戻り値

  指定された languageTag と完全に一致する DigitalInkRecognitionModelIdentifier。見つからなかった場合は nil。

• +allModelIdentifiers

  使用可能なすべてのモデル ID のセットを返します。

  宣言

  Objective-C

  + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
      allModelIdentifiers;

• +modelIdentifiersForLanguageSubtag:

  指定された言語サブタグをサポートするモデル ID のセットを返します。

  たとえば "en" の場合、enUs（英語、米国）、enUk（英語、英国）、enKe（英語、ケニア）などを含むモデル ID のセットが返されます。

  言語サブタグをサポートするモデル ID が見つからない場合は、空のセットが返されます。

  宣言

  Objective-C

  + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
      modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;

  パラメータ

  languageSubtag

  2 文字または 3 文字の ISO 639 言語コード（例: 英語の場合は "en"）。

  戻り値

  指定された languageSubtag をサポートするモデル ID のセットは、空でもかまいません。

• +modelIdentifiersForScriptSubtag:

  指定された script サブタグをサポートするモデル ID のセットを返します。

  たとえば "Latn" の場合、enUs（英語、米国）、frFr（フランス語、フランス）、guLatn（グジャラート語、ラテン文字）などを含むモデル ID のセットが返されます。

  この関数は、指定された script サブタグのスーパーセットをサポートするモデル ID も返します。たとえば、Hant（Han、従来型バリアント）の場合は、Hant が Hani のサブセットであるため、zh-Hani 認識モデルを返します（Han は従来のバリアントと簡易バリアントの両方）。

  script サブタグをサポートするモデル ID が見つからない場合は、空のセットが返されます。

  宣言

  Objective-C

  + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
      modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;

  パラメータ

  scriptSubtag

  4 文字の ISO 15924 標準コード。たとえば、ラテン文字の場合は "Latn"、アラビア文字の場合は "Arab" です。

  戻り値

  指定された scriptSubtag をサポートするモデル ID のセットは、空でもかまいません。

• +modelIdentifiersForRegionSubtag:

  指定された region サブタグに固有のモデル ID のセットを返します。

  たとえば "CH" の場合、deCh（ドイツ語、スイス）、frCh（フランス語、スイス）、itCh（イタリア語、スイス）、rmCh（ロマンシュ、スイス）を含むモデル ID のセットが返されます。

  この関数は、指定した region サブタグを含む地域、または指定された region サブタグに含まれる地域に固有のモデル ID を返します。たとえば、DZ（アルジェリア）を検索すると fr-002（フランス語、アフリカ）認識モデルを含む結果が生成され、その逆も同様です。

  リージョン サブタグをサポートするモデル ID が見つからない場合は、空のセットが返されます。

  宣言

  Objective-C

  + (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *)
      modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;

  パラメータ

  regionSubtag

  2 文字の ISO 3166-1 Alpha 2 標準地域コード、または UN M.49 規格で定義されている数値コード（たとえば、ドイツは "DE"、アフリカは "002"）。

  戻り値

  指定された regionSubtag に固有のモデル ID のセットは、空にすることもできます。