Riferimento al framework MLKitDigitalInkRecognition

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

Rappresenta un modello di riconoscimento dell'inchiostro digitale specifico per una lingua, una scrittura e, facoltativamente, una variante regionale.

  • Tag della lingua conforme a BCP 47 per questo modello.

    Dichiarazione

    Swift

    var languageTag: String { get }

  • Sottotag della lingua, ovvero il codice lingua ISO 639 a due o tre lettere per questo modello di riconoscimento, ad esempio "en" per l'inglese.

    Dichiarazione

    Swift

    var languageSubtag: String { get }

  • Sottotag dello script, ovvero il codice standard ISO 15924 di quattro lettere della scrittura utilizzata in questo modello di riconoscimento, ad esempio "Latn" per l'alfabeto latino o "Arab" per l'alfabeto arabo.

    Dichiarazione

    Swift

    var scriptSubtag: String? { get }

  • Sottotag regione, ovvero i codici regione a due lettere dello standard ISO 3166-1 Alpha 2 o l'insieme di codici numerici definiti dallo standard UN M.49, ad esempio "DE" per la Germania o "002" per l'Africa.

    Dichiarazione

    Swift

    var regionSubtag: String? { get }

  • Usa invece il criterio from(languageTag:).

  • Restituisce l'identificatore di modello che meglio corrisponde alla lingua, allo script (se presente) e alla regione (se presente) codificati nel formato languageTag di BCP 47.

    La corrispondenza è del tipo best effort, ovvero restituisce l'identificatore del modello che corrisponde meglio al valore languageTag fornito utilizzando la seguente euristica:

  • Se non è possibile trovare alcun identificatore di modello per il sottotag della lingua richiesto, ma il secondo fa parte di una macrolingua supportata, la corrispondenza con la macrolingua, ad esempio "arb" (arabo standard) corrisponderà a "ar" (arabo).

  • Se non viene fornito alcuno script e nessuno di questi è implicito per il sottotag della lingua richiesto, effettua una corrispondenza con qualsiasi script.

  • Se il sottotag dello script fornito o implicito è un sottoinsieme di uno script supportato, crea una corrispondenza anche con il secondo, ad esempio "zh-Hant" (cinese, han tradizionale) corrisponderà a "zh-Hani" (cinese, han).

  • Se non viene specificato alcun sottotag della regione, cerca una corrispondenza con qualsiasi regione, dando la preferenza agli identificatori di modello che non specificano anche una regione, ad esempio "ro" (rumeno) corrisponderà a "ro-RO" (rumeno, Romania).

  • Se viene specificato un sottotag della regione, ma non è possibile trovare una corrispondenza, la corrispondenza con le regioni contenenti la regione specificata, ad esempio "fr-DZ" (francese, Algeria) corrisponderà a "fr-002" (francese, Africa).

    Se non è possibile trovare alcun identificatore del modello, restituisce nil.

    • Dichiarazione

    Swift

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

    Parametri

    languageTag

    Un tag di lingua IETF BCP 47 che rappresenta la lingua richiesta.
    error

    L'oggetto del messaggio di errore facoltativo verrà completato se non è possibile analizzare il valore languageTag.

    Valore restituito

    un identificatore del modello che corrisponde esattamente al tag lingua fornito, la migliore corrispondenza approssimativa oppure nil se non è possibile trovare un identificatore di modello appropriato. Impostato anche su nil se non è stato possibile analizzare il tag della lingua.

  • Restituisce un identificatore del modello che corrisponde esattamente al valore languageTag specificato.

    Differisce da from(LanguageTag:) per il fatto che non tenta di analizzare languageTag (e quindi non genera errori) e restituisce solo l'identificatore del modello che corrisponde esattamente a languageTag, se esistente.

    Dichiarazione

    Swift

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

    Parametri

    languageTag

    Il tag di lingua IETF BCP 47 dell'identificatore del modello richiesto.

    Valore restituito

    Un elemento DigitalInkRecognitionModelIdentifier che corrisponde esattamente al valore languageTag fornito o nil se non ne è stato trovato nessuno.

  • Restituisce l'insieme di tutti gli identificatori di modello disponibili.

    Dichiarazione

    Swift

    class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>

  • Restituisce l'insieme di identificatori di modello che supportano il sottotag della lingua specificato.

    Ad esempio, per "en", verrà restituito un insieme di identificatori di modello contenenti enUs (inglese, Stati Uniti), enUk (inglese, Regno Unito), enKe (inglese, Kenya) e così via.

    Se non vengono trovati identificatori di modello che supportano il sottotag della lingua, viene restituito un set vuoto.

    Dichiarazione

    Swift

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

    Parametri

    languageSubtag

    Un codice lingua ISO 639 di 2 o 3 lettere, ad esempio "en" per l'inglese.

    Valore restituito

    Un insieme di identificatori di modello che supportano il valore languageSubtag fornito potrebbe essere vuoto.

  • Restituisce l'insieme di identificatori di modello che supportano il sottotag dello script specificato.

    Ad esempio, per "Latn", verrebbe restituito un insieme di identificatori di modello contenenti enUs (inglese, Stati Uniti), frFr (francese, Francia), guLatn (gujarati, alfabeto latino) e così via.

    Questa funzione restituisce anche identificatori di modello che supportano un soprainsieme del sottotag dello script specificato. Ad esempio, per Hant (Han, variante tradizionale), questa funzione restituirà i modelli di riconoscimento zh-Hani poiché Hant è un sottoinsieme di Hani (Han, varianti tradizionali e semplificate).

    Se non vengono trovati identificatori di modello che supportano il sottotag dello script, restituisce un set vuoto.

    Dichiarazione

    Swift

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

    Parametri

    scriptSubtag

    Un codice standard ISO 15924 di quattro lettere, ad esempio "Latn" per l'alfabeto latino o "Arab" per l'alfabeto arabo.

    Valore restituito

    Un insieme di identificatori di modello che supportano il valore scriptSubtag fornito potrebbe essere vuoto.

  • Restituisce l'insieme di identificatori di modello specifici per il sottotag della regione specificato.

    Ad esempio, per "CH", verrà restituito un insieme di identificatori di modello contenenti deCh (tedesco, Svizzera), frCh (francese, Svizzera), itCh (italiano, Svizzera) e rmCh (romancio, Svizzera).

    Questa funzione restituisce anche identificatori di modello specifici per le regioni che contengono il sottotag della regione specificato o che sono contenuti nel sottotag della regione specificato, ad esempio la ricerca di DZ (Algeria) produrrà risultati che includono il modello di riconoscimento fr-002 (francese, Africa) e viceversa.

    Se non vengono trovati identificatori di modello che supportano il sottotag regione, restituisce un set vuoto.

    Dichiarazione

    Swift

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

    Parametri

    regionSubtag

    Un codice regione standard ISO 3166-1 Alpha 2 a due lettere o uno dei codici numerici definiti dallo standard UN M.49, ad esempio "DE" per la Germania o "002" per l'Africa.

    Valore restituito

    Un insieme di identificatori di modello specifici per l'elemento regionSubtag fornito può essere vuoto.