MLKitDigitalInkRecognition-Framework-Referenz

DigitalInkRecognitionModelIdentifier

class DigitalInkRecognitionModelIdentifier : NSObject

Stellt ein digitales Tintenerkennungsmodell dar, das für eine Sprache, ein Skript und optional eine regionale Variante spezifisch ist.

  • BCP 47-konformes Sprach-Tag für dieses Modell.

    Erklärung

    Swift

    var languageTag: String { get }

  • Sprach-Subtag, also der aus zwei oder drei Buchstaben bestehende ISO 639-Sprachcode für dieses Erkennungsmodell, z. B. "en" für Englisch.

    Erklärung

    Swift

    var languageSubtag: String { get }

  • Skript-Subtag, also der aus vier Buchstaben bestehende ISO 15924-Standardcode des in diesem Erkennungsmodell verwendeten Skripts, z. B. "Latn" für lateinische Schrift oder "Arab" für arabische Schrift.

    Erklärung

    Swift

    var scriptSubtag: String? { get }

  • Das Subtag für die Region, d.h. die aus zwei Buchstaben bestehenden Standardregioncodes nach ISO 3166-1 Alpha 2 oder die durch den Standard UN M.49 definierte Gruppe von numerischen Codes, z.B. "DE" für Deutschland oder "002" für Afrika.

    Erklärung

    Swift

    var regionSubtag: String? { get }

  • Verwenden Sie stattdessen from(languageTag:).

  • Gibt eine Modellkennung zurück, die am besten mit der Sprache, dem Skript (falls vorhanden) und der Region (falls vorhanden) übereinstimmt, die im BCP 47-formatierten languageTag codiert sind.

    Der Abgleich erfolgt auf Best-Effort-Basis, d. h., er gibt die Modellkennung zurück, die am besten mit dem angegebenen languageTag übereinstimmt. Dabei wird die folgende Heuristik verwendet:

  • Wenn für das angeforderte Sprach-Subtag keine Modellkennung gefunden wird, Letzteres jedoch Teil einer unterstützten Makrosprache ist, gleichen Sie den Abgleich mit der Makrosprache ab, z.B. stimmt "arb" (Standardarabisch) mit "ar" (Arabisch) überein.

  • Wenn kein Skript angegeben wird und kein Skript für das angeforderte Sprach-Subtag implizit ist, gleichen Sie den Abgleich mit einem beliebigen Skript ab.

  • Wenn das angegebene oder implizite Skript-Subtag eine Teilmenge eines unterstützten Skripts ist, gleichen Sie es auch mit dem zweiten Skript ab. Beispiel: "zh-Hant" (Chinesisch, traditionelles Han) wird mit "zh-Hani" (Chinesisch, Han) abgeglichen.

  • Wenn kein Regions-Subtag angegeben ist, wird der Abgleich mit einer beliebigen Region durchgeführt.Dabei werden Modellkennungen bevorzugt, die auch keine Region angeben. Beispiel: "ro" (Rumänisch) wird mit "ro-RO" (Rumänisch, Rumänien) übereinstimmen.

  • Wenn ein Regions-Subtag angegeben ist, aber nicht abgeglichen werden kann, wird der Abgleich mit Regionen durchgeführt, die die angegebene Region enthalten. Beispiel: "fr-DZ" (Französisch, Algerien) wird mit "fr-002" (Französisch, Afrika) abgeglichen.

    Wenn keine Modellkennung gefunden wird, wird nil zurückgegeben.

    • Erklärung

    Swift

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

    Parameter

    languageTag

    Ein IETF BCP 47-Sprach-Tag, das die angeforderte Sprache darstellt.
    error

    Optionales Fehlermeldungsobjekt, das ausgefüllt wird, wenn languageTag nicht geparst werden kann.

    Rückgabewert

    Eine Modellkennung, die genau mit dem angegebenen Sprach-Tag übereinstimmt oder die genaueste ungefähre Übereinstimmung oder nil, wenn keine entsprechende Modellkennung gefunden wird Legen Sie auch nil fest, wenn das Sprach-Tag nicht geparst werden konnte.

  • Gibt eine Modellkennung zurück, die genau mit dem angegebenen languageTag übereinstimmt.

    Der Unterschied zu from(LanguageTag:) besteht darin, dass nicht versucht wird, languageTag zu parsen (und somit keine Fehler generiert). Stattdessen wird nur die Modellkennung zurückgegeben, die genau mit languageTag übereinstimmt, sofern vorhanden.

    Erklärung

    Swift

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

    Parameter

    languageTag

    Das IETF-BCP-47-Sprach-Tag der angeforderten Modellkennung.

    Rückgabewert

    Ein DigitalInkRecognitionModelIdentifier, der genau mit der angegebenen languageTag übereinstimmt oder nil, wenn keiner gefunden wurde.

  • Gibt den Satz aller verfügbaren Modellkennungen zurück

    Erklärung

    Swift

    class func allModelIdentifiers() -> Set<DigitalInkRecognitionModelIdentifier>

  • Gibt den Satz von Modellkennungen zurück, die das angegebene Sprach-Subtag unterstützen.

    Für "en" wird beispielsweise eine Reihe von Modellkennungen zurückgegeben, die enUs (Englisch, USA), enUk (Englisch, Vereinigtes Königreich), enKe (Englisch, Kenia) usw. enthalten.

    Wenn keine Modellkennungen gefunden werden, die das Sprach-Subtag unterstützen, wird ein leerer Satz zurückgegeben.

    Erklärung

    Swift

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

    Parameter

    languageSubtag

    Ein aus zwei oder drei Buchstaben bestehender ISO 639-Sprachcode, z. B. "en" für Englisch

    Rückgabewert

    Eine Reihe von Modellkennungen, die den angegebenen languageSubtag unterstützen, kann leer sein.

  • Gibt die Modellkennungen zurück, die das angegebene Skript-Subtag unterstützen

    Für "Latn" wird beispielsweise eine Reihe von Modellkennungen zurückgegeben, die enUs (Englisch, USA), frFr (Französisch, Frankreich), guLatn (Gujarati, lateinische Schrift) usw. enthalten.

    Diese Funktion gibt auch Modellkennungen zurück, die eine Obermenge des angegebenen Skript-Subtags unterstützen. Beispiel: Für Hant (Han, traditionelle Variante) gibt diese Funktion die zh-Hani-Erkennungsmodelle zurück, da Hant eine Teilmenge von Hani ist (Han, sowohl traditionelle als auch vereinfachte Varianten).

    Wenn keine Modellkennungen gefunden werden, die das Skript-Subtag unterstützen, wird ein leerer Satz zurückgegeben.

    Erklärung

    Swift

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

    Parameter

    scriptSubtag

    Ein aus vier Buchstaben bestehender ISO 15924-Standardcode, z.B. "Latn" für lateinische Schrift oder "Arab" für arabische Schrift.

    Rückgabewert

    Eine Reihe von Modellkennungen, die den angegebenen scriptSubtag unterstützen, kann leer sein.

  • Gibt den Satz von Modellkennungen zurück, die für das angegebene Regions-Subtag spezifisch sind.

    Für "CH" wird beispielsweise eine Reihe von Modellkennungen zurückgegeben, die deCh (Deutsch, Schweiz), frCh (Französisch, Schweiz), itCh (Italienisch, Schweiz) und rmCh (Romanisch, Schweiz) enthalten.

    Diese Funktion gibt auch Modellkennungen zurück, die für Regionen spezifisch sind, die das angegebene Regions-Subtag enthalten oder in diesem enthalten sind. Wenn Sie beispielsweise nach DZ (Algerien) suchen, erhalten Sie Ergebnisse, die das Erkennungsmodell fr-002 (Französisch, Afrika) enthalten und umgekehrt.

    Wenn keine Modellkennungen gefunden werden, die das Subtag für die Region unterstützen, wird ein leerer Satz zurückgegeben.

    Erklärung

    Swift

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

    Parameter

    regionSubtag

    Ein aus zwei Buchstaben bestehender ISO 3166-1 Alpha 2-Standard-Regionscode oder einer der durch UN M.49 definierten numerischen Codes, z.B. "DE" für Deutschland oder "002" für Afrika.

    Rückgabewert

    Eine Reihe von Modellkennungen, die für die angegebene regionSubtag spezifisch sind, kann leer sein.