Documentation de référence sur le framework MLKitDigitalInkRecognition

MLKDigitalInkRecognitionModelIdentifier


@interface MLKDigitalInkRecognitionModelIdentifier : NSObject

Représente un modèle de reconnaissance d'encre numérique spécifique à une langue, à un script et éventuellement à une variante régionale.

  • Balise de langue conforme à la norme BCP 47 pour ce modèle.

    Déclaration

    Objective-C

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

  • Sous-tag de la langue, c'est-à-dire le code de langue ISO 639 à deux ou trois lettres pour ce modèle de reconnaissance, par exemple "en" pour l'anglais.

    Déclaration

    Objective-C

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

  • Sous-tag du script, c'est-à-dire le code standard ISO 15924 à quatre lettres du script utilisé dans ce modèle de reconnaissance (par exemple, "Latn" pour l'alphabet latin ou "Arab" pour l'arabe).

    Déclaration

    Objective-C

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

  • Sous-tag de région, c'est-à-dire les codes régionaux à deux lettres de la norme ISO 3166-1 Alpha 2 ou l'ensemble de codes numériques définis par la norme UN M.49 (par exemple, "DE" pour l'Allemagne ou "002" pour l'Afrique).

    Déclaration

    Objective-C

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

  • Utilisez from(languageTag:) à la place.

    Déclaration

    Objective-C

    - (nonnull instancetype)init;

  • Renvoie un identifiant de modèle qui correspond le mieux à la langue, au script (le cas échéant) et à la région (le cas échéant) encodés au format languageTag BCP 47.

    La mise en correspondance est la plus optimale possible, c'est-à-dire qu'elle renvoie l'identifiant du modèle qui correspond le mieux à la valeur languageTag fournie à l'aide des méthodes heuristiques suivantes:

  • Si aucun identifiant de modèle n'est trouvé pour le sous-tag de langue demandé, mais que celui-ci fait partie d'une macrolangue compatible, faites correspondre la macrolangue. Par exemple, "arb" (arabe standard) correspondra à "ar" (arabe).

  • Si aucun script n'est fourni et qu'aucun script n'est implicite pour le sous-tag de langue demandé, effectuez la correspondance avec n'importe quel script.

  • Si le sous-tag de script fourni ou implicite est un sous-ensemble d'un script compatible, faites également correspondre ce dernier. Par exemple, "zh-Hant" (chinois, chinois traditionnel) correspondra à "zh-Hani" (chinois, chinois traditionnel).

  • Si aucun sous-tag de région n'est spécifié, mettez en correspondance toutes les régions, en privilégiant les identifiants de modèle qui ne spécifient pas de région. Par exemple, "ro" (roumain) correspondra à "ro-RO" (roumain, Roumanie).

  • Si un sous-tag de région est spécifié, mais ne peut pas être mis en correspondance, mettez en correspondance les régions contenant la région spécifiée. Par exemple, "fr-DZ" (français, Algérie) correspondra à "fr-002" (français, Afrique).

    Si aucun identifiant de modèle n'est trouvé, la fonction renvoie nil.

    • Déclaration

    Objective-C

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

    Paramètres

    languageTag

    Balise de langue IETF BCP 47 représentant la langue demandée.
    error

    Objet de message d'erreur facultatif qui sera renseigné si languageTag ne peut pas être analysé.

    Valeur renvoyée

    Un identifiant de modèle correspondant exactement au tag de langue fourni, ou la meilleure correspondance proche, ou nil si aucun identifiant de modèle approprié n'a été trouvé. Également défini sur nil si le tag de langue n'a pas pu être analysé.

  • Renvoie un identifiant de modèle qui correspond exactement à l'élément languageTag donné.

    diffère de from(LanguageTag:) en ce sens qu'il ne tente pas d'analyser l'languageTag (et ne génère donc pas d'erreurs) et renvoie simplement l'identifiant de modèle qui correspond exactement à languageTag, s'il existe.

    Déclaration

    Objective-C

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

    Paramètres

    languageTag

    Balise de langue IETF BCP 47 de l'identifiant de modèle demandé.

    Valeur renvoyée

    Une valeur DigitalInkRecognitionModelIdentifier correspondant exactement à l'élément languageTag fourni ou nil si aucun élément n'a été trouvé.

  • Renvoie l'ensemble de tous les identifiants de modèles disponibles.

    Déclaration

    Objective-C

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

  • Renvoie l'ensemble des identifiants de modèle compatibles avec le sous-tag de langue donné.

    Par exemple, pour "en", cela renvoie un ensemble d'identifiants de modèle contenant enUs (anglais, États-Unis), enUk (anglais, Royaume-Uni), enKe (anglais, Kenya), etc.

    Si aucun identifiant de modèle prenant en charge le sous-tag de langue n'est trouvé, la fonction renvoie un ensemble vide.

    Déclaration

    Objective-C

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

    Paramètres

    languageSubtag

    Code de langue ISO 639 à deux ou trois lettres, par exemple "en" pour l'anglais.

    Valeur renvoyée

    Un ensemble d'identifiants de modèle compatibles avec la languageSubtag fournie peut être vide.

  • Renvoie l'ensemble des identifiants de modèle compatibles avec le sous-tag de script donné.

    Par exemple, pour "Latn", cela renverra un ensemble d'identifiants de modèle contenant enUs (anglais, États-Unis), frFr (français, France), guLatn (gujarati, script latin), etc.

    Cette fonction renvoie également des identifiants de modèle compatibles avec un sur-ensemble du sous-tag de script donné. Par exemple, pour Hant (variante Han, traditionnelle), elle renvoie les modèles de reconnaissance zh-Hani, car Hant est un sous-ensemble de Hani (variantes de Han, à la fois traditionnelles et simplifiées).

    Si aucun identifiant de modèle prenant en charge le sous-tag de script n'est trouvé, la fonction renvoie un ensemble vide.

    Déclaration

    Objective-C

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

    Paramètres

    scriptSubtag

    Code ISO 15924 à quatre lettres, par exemple "Latn" pour l'alphabet latin ou "Arab" pour l'alphabet arabe.

    Valeur renvoyée

    Un ensemble d'identifiants de modèle compatibles avec la scriptSubtag fournie peut être vide.

  • Renvoie l'ensemble des identifiants de modèle spécifiques au sous-tag de région donné.

    Par exemple, pour "CH", cela renvoie un ensemble d'identifiants de modèle contenant deCh (allemand, Suisse), frCh (français, Suisse), itCh (italien, Suisse) et rmCh (roman, Suisse).

    Cette fonction renvoie également des identifiants de modèle spécifiques aux régions qui contiennent le sous-tag de région donné ou qui sont contenus par le sous-tag de région donné. Par exemple, la recherche de DZ (Algérie) produit des résultats qui incluent le modèle de reconnaissance fr-002 (français, Afrique), et inversement.

    Si aucun identifiant de modèle prenant en charge le sous-tag région n'est trouvé, la fonction renvoie un ensemble vide.

    Déclaration

    Objective-C

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

    Paramètres

    regionSubtag

    Code régional à deux lettres ISO 3166-1 Alpha 2 ou l'un des codes numériques définis par la norme UN M.49 (par exemple, "DE" pour l'Allemagne ou "002" pour l'Afrique).

    Valeur renvoyée

    Un ensemble d'identifiants de modèle spécifiques au regionSubtag fourni peut être vide.