Dokumentacja platformy MLKitDigitalInkRecognition Framework

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

Reprezentuje model rozpoznawania cyfrowego atramentu specyficzny dla języka, skryptu i opcjonalnie wariantu regionalnego.

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

    Deklaracja

    Swift

    var languageTag: String { get }

  • Subtag języka, czyli 2 lub 3-literowy kod języka ISO 639 dla tego modelu rozpoznawania, np. "en" dla języka angielskiego.

    Deklaracja

    Swift

    var languageSubtag: String { get }

  • Subtag skryptu, czyli czteroliterowy kod standardu ISO 15924, używany w tym model rozpoznawania, np. "Latn" dla pisma łacińskiego lub "Arab" dla pisma arabskiego.

    Deklaracja

    Swift

    var scriptSubtag: String? { get }

  • Podtag regionu, np. dwuliterowe kody regionów w standardzie ISO 3166-1 alfa 2 lub zestaw kodów numerycznych zdefiniowanych w normie UN 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 dowolne) oraz region (jeśli występuje) zakodowany w formacie BCP 47 languageTag.

    Dopasowanie odbywa się z najwyższą starannością, tzn. zwraca identyfikator modelu, który najlepiej pasuje do podanej wartości languageTag przy użyciu tej heurystyki:

  • Jeśli nie można znaleźć identyfikatora modelu dla żądanego subtagu języka, ale ten drugi tag to część obsługiwanego języka makr, dopasowanie do makra makrolanguage, np. "arb" (standardowa) arabski) będzie pasować do "ar" (arabski).

  • Jeśli nie podano żadnego skryptu i nie określono żadnego skryptu dla żądanego subtagu języka, dopasuj z dowolnym skryptem.

  • Jeśli podany lub niejawny subtag skryptu jest podzbiorem obsługiwanego skryptu, dopasuj go do również to drugie, np. Mecz "zh-Hant" (chiński i tradycyjny) zmierzy się z "zh-Hani" (chiński, han).

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

  • Jeśli określono subtag regionu, ale nie można go dopasować, dopasuj go do regionów zawierających tag określony region, np. "fr-DZ" (francuski, Algieria) zmierzy się z "fr-002" (francuski, Afryce).

    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 zapełniony, jeśli obiektu languageTag nie będzie można przeanalizowano.

    Zwracana wartość

    identyfikator modelu dokładnie zgodny z podanym tagiem języka lub najlepiej przybliżony lub nil, jeśli nie można znaleźć odpowiedniego identyfikatora modelu. Ustaw także na nil, jeśli nie można przeanalizować tagu języka.

  • Zwraca identyfikator modelu, który dokładnie odpowiada podanej funkcji languageTag.

    Różni się od from(LanguageTag:) tym, że nie próbuje analizować elementu languageTag (i nie generuje błędów) i zwraca tylko identyfikator modelu pasujący do: languageTag, o ile istnieje.

    Deklaracja

    Swift

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

    Parametry

    languageTag

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

    Zwracana wartość

    DigitalInkRecognitionModelIdentifier dokładnie pasuje do podanej wartości languageTag lub nil, jeśli nie znaleziono żadnej.

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

    Deklaracja

    Swift

    class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>

  • Zwraca zbiór identyfikatorów modelu, który obsługuje dany subtag języka.

    Na przykład: w przypadku "en" zwróciłoby zestaw identyfikatorów modelu zawierający enUs (angielski, Stany Zjednoczone), enUk (angielski, Wielka Brytania), enKe (angielski, Kenia) itp.

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

    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" dla języka angielskiego.

    Zwracana wartość

    Zbiór identyfikatorów modeli, które obsługują podany languageSubtag, może być pusty.

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

    Na przykład: w przypadku "Latn" zwróciłoby zestaw identyfikatorów modelu zawierający enUs (angielski, Stany Zjednoczone), frFr (francuski, Francja), guLatn (gudżarati, pismo łacińskie) itp.

    Ta funkcja zwraca również identyfikatory modelu, które obsługują nadzbiór danego skryptu subtag, np. dla funkcji Hant (Han, odmiana tradycyjna), ta funkcja zwróci wartość zh-Hani modele rozpoznawania, ponieważ Hant są podzbiorem modelu Hani (Han, zarówno uproszczone warianty).

    Jeśli nie można znaleźć żadnych identyfikatorów modeli obsługujących subtag skryptu, zwraca pusty zbiór.

    Deklaracja

    Swift

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

    Parametry

    scriptSubtag

    Czteroliterowy kod standardu ISO 15924, np. "Latn" (alfabet łaciński) lub "Arab" dla pisma arabskiego.

    Zwracana wartość

    Zbiór identyfikatorów modeli, które obsługują podany scriptSubtag, może być pusty.

  • Zwraca zbiór identyfikatorów modelu, które są specyficzne dla danego subtagu regionu.

    Na przykład: dla "CH" zwróciłoby zestaw identyfikatorów modelu zawierający deCh (niemiecki, Szwajcaria), frCh (francuski, Szwajcaria), itCh (włoski, Szwajcaria) i rmCh (rzymski, Szwajcarii).

    Ta funkcja zwraca też identyfikatory modelu specyficzne dla regionów, które zawierają podaną wartość regionu lub są zawarte w danym podtagu regionu, np. wyszukiwanie hasła DZ (Algieria) zwróci wyniki obejmujące model rozpoznawania fr-002 (francuski, Afryka) oraz i na odwrót.

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

    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 kodów numerycznych zdefiniowanych w normie UN M.49, np. "DE" dla Niemiec lub "002" dla Afryki.

    Zwracana wartość

    Zbiór identyfikatorów modelu charakterystycznych dla podanego elementu regionSubtag może być puste.