Dokumentacja platformy MLKitDigitalInkRecognition Framework

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

Reprezentuje model rozpoznawania cyfrowego atramentu właściwy dla języka, skryptu i opcjonalnie wersji regionalnej.

  • Tag języka zgodny z BCP 47 dla tego modelu.

    Deklaracja

    Swift

    var languageTag: String { get }

  • Subtag języka, np. 2- lub 3-literowy kod języka w standardzie ISO 639 używany w tym modelu rozpoznawania, np. "en" w przypadku języka angielskiego.

    Deklaracja

    Swift

    var languageSubtag: String { get }

  • Subtag skryptu, czyli czteroliterowy standardowy kod języka ISO 15924 używany w tym modelu rozpoznawania, np. "Latn" dla alfabetu łacińskiego lub "Arab" dla pisma arabskiego.

    Deklaracja

    Swift

    var scriptSubtag: String? { get }

  • Subtag regionu, np. dwuliterowe kody regionów zgodne ze standardem ISO 3166-1 alfa-2 lub zestaw kodów numerycznych określonych w normie ONZ M.49, np. "DE" dla Niemiec lub "002" dla Afryki.

    Deklaracja

    Swift

    var regionSubtag: String? { get }

  • Użyj w zamian zasady from(languageTag:).

  • Zwraca identyfikator modelu, który najlepiej pasuje do języka, skryptu (jeśli występuje) i regionu (jeśli występuje) zakodowanego w BCP 47 w formacie languageTag.

    Dopasowywanie działa zgodnie z zasadą możliwie najlepszej obsługi, co oznacza, że zwraca identyfikator modelu, który najlepiej pasuje do podanej wartości languageTag, z użyciem tych danych heurystycznych:

  • Jeśli nie można znaleźć identyfikatora modelu dla żądanego podtagu języka, ale ten drugi jest częścią obsługiwanego języka makro, dopasowanie do języka makra, np. "arb" (standardowy arabski) spowoduje dopasowanie do "ar" (arabski).

  • Jeśli nie podano żadnego skryptu i żaden skrypt nie jest niejawny w żądanym subtagu języka, dopasuj do dowolnego skryptu.

  • Jeśli podany lub niejawny podtag skryptu jest podzbiorem obsługiwanego skryptu, dopasowanie również do tego drugiego, np. "zh-Hant" (chiński tradycyjny han) będzie pasować do "zh-Hani" (chiński i han).

  • Jeśli nie określono żadnego subtagu regionu, dopasuj go do dowolnego regionu, preferując identyfikatory modelu, które również nie określają regionu, np. "ro" (rumuński) będzie pasować do "ro-RO" (rumuński, Rumunia).

  • Jeśli podano podtag regionu, ale nie można go dopasować, dopasowanie do regionów zawierających określony region, np. "fr-DZ" (francuski, Algieria) będzie pasować do regionów "fr-002" (francuski, Afryka).

    Jeśli nie można znaleźć identyfikatora modelu, zwraca nil.

    • Deklaracja

    Swift

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

    Parametry

    languageTag

    Tag języka IETF BCP 47 reprezentujący żądany język.
    error

    Opcjonalny obiekt komunikatu o błędzie zostanie wypełniony, jeśli nie uda się przeanalizować languageTag.

    Zwracana wartość

    identyfikator modelu ściśle pasuje do podanego tagu języka lub najbardziej przybliżone dopasowanie, albo nil, jeśli nie można znaleźć odpowiedniego identyfikatora modelu. Ustaw też wartość nil, jeśli nie udało się przeanalizować tagu języka.

  • Zwraca identyfikator modelu, który dokładnie odpowiada podanej wartości languageTag.

    Różni się od from(LanguageTag:) tym, że nie próbuje przeanalizować obiektu languageTag (i dlatego nie generuje błędów) i zwraca tylko identyfikator modelu, który dokładnie pasuje do languageTag, jeśli taki istnieje.

    Deklaracja

    Swift

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

    Parametry

    languageTag

    Tag języka IETF BCP 47 żądanego identyfikatora modelu.

    Zwracana wartość

    Wartość DigitalInkRecognitionModelIdentifier odpowiadająca podanej wartości languageTag dokładnie lub nil, jeśli nie znaleziono żadnej wartości.

  • Zwraca zbiór wszystkich dostępnych identyfikatorów modelu.

    Deklaracja

    Swift

    class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>

  • Zwraca zbiór identyfikatorów modelu, które obsługują dany podtag języka.

    Np. w przypadku "en" spowoduje to zwrócenie zestawu identyfikatorów modelu zawierającego enUs (angielski, Stany Zjednoczone), enUk (angielski, Wielka Brytania), enKe (angielski, Kenia) itd.

    Jeśli nie można znaleźć identyfikatorów modelu obsługujących podtag języka, zwraca pusty zestaw.

    Deklaracja

    Swift

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

    Parametry

    languageSubtag

    2- lub 3-literowy kod języka w formacie ISO 639, np. "en" w przypadku języka angielskiego.

    Zwracana wartość

    Zestaw identyfikatorów modelu, które obsługują podane atrybuty languageSubtag, może być pusty.

  • Zwraca zbiór identyfikatorów modelu, które obsługują dany podtag skryptu.

    Np. w przypadku "Latn" spowoduje to zwrócenie zestawu identyfikatorów modelu zawierającego enUs (angielski, Stany Zjednoczone), frFr (francuski, francuski), guLatn (gudżarati, pismo łacińskie) itd.

    Ta funkcja zwraca również identyfikatory modelu, które obsługują superzbiór danego podtagu skryptu, np. dla Hant (Han, wariant tradycyjny), funkcja zwraca modele rozpoznawania zh-Hani, ponieważ Hant jest podzbiorem elementu Hani (odmiana tradycyjna i uproszczony) Hani.

    Jeśli nie można znaleźć identyfikatorów modelu obsługujących podtag skryptu, zwraca pusty zestaw.

    Deklaracja

    Swift

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

    Parametry

    scriptSubtag

    4-literowy kod standardowy ISO 15924, np. "Latn" dla alfabetu łacińskiego lub "Arab" dla pisma arabskiego.

    Zwracana wartość

    Zestaw identyfikatorów modelu, które obsługują podane atrybuty scriptSubtag, może być pusty.

  • Zwraca zbiór identyfikatorów modelu specyficznych dla danego podtagu regionu.

    Np. w przypadku "CH" spowoduje to zwrócenie zestawu identyfikatorów modeli zawierających deCh (niemiecki, Szwajcaria), frCh (francuski, szwajcarski), itCh (włoski, Szwajcaria) i rmCh (język rzymski, Szwajcaria).

    Ta funkcja zwraca też identyfikatory modeli specyficzne dla regionów, które zawierają dany podtag regionu lub zawarte w nim. Na przykład wyszukiwanie DZ (Algieria) zwróci wyniki obejmujące model rozpoznawania fr-002 (francuski i Afryka) i odwrotnie.

    Jeśli nie można znaleźć identyfikatorów modelu obsługujących podtag regionu, zwraca pusty zestaw.

    Deklaracja

    Swift

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

    Parametry

    regionSubtag

    Dwuliterowy kod regionu zgodny ze standardem ISO 3166-1 alfa 2 lub jeden z kodów numerycznych określonych w normie ONZ M.49, np. "DE" dla Niemiec lub "002" dla Afryki.

    Zwracana wartość

    Zestaw identyfikatorów modelu, które są charakterystyczne dla podanej wartości regionSubtag, może być pusty.