MLKDigitalInkRecognitionModelIdentifier
@interface MLKDigitalInkRecognitionModelIdentifier : NSObject
Stellt ein digitales Tintenerkennungsmodell dar, das spezifisch für eine Sprache, ein Skript und optional ein regionale Variante.
-
BCP 47-konformes Sprach-Tag für dieses Modell.
Erklärung
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageTag;
-
Sprach-Subtag, d.h. der aus zwei oder drei Buchstaben bestehende Sprachcode nach ISO 639 für dieses Erkennungsmodell, z.B.
"en"
für Englisch.Erklärung
Objective-C
@property (nonatomic, readonly) NSString *_Nonnull languageSubtag;
-
Skript-Subtag, d.h. der aus vier Buchstaben bestehende ISO 15924-Standardcode des Skripts, das in diesem Erkennungsmodell, z.B.
"Latn"
für lateinische oder"Arab"
für arabische Schrift.Erklärung
Objective-C
@property (nonatomic, readonly, nullable) NSString *scriptSubtag;
-
Subtag für die Region, d.h. die aus zwei Buchstaben bestehenden Regionscodes gemäß ISO 3166-1 Alpha 2 oder eine Reihe von numerische Codes, die durch den UN M.49-Standard definiert sind, z.B.
"DE"
für Deutschland oder"002"
für Afrika.Erklärung
Objective-C
@property (nonatomic, readonly, nullable) NSString *regionSubtag;
-
Verwenden Sie stattdessen
from(languageTag:)
.Erklärung
Objective-C
- (nonnull instancetype)init;
-
Gibt einen Modell-Identifikator zurück, der am besten mit der Sprache, dem Skript (wenn beliebige) und Region (falls vorhanden) im BCP 47-Format codiert (
languageTag
).Der Abgleich erfolgt auf Best-Effort-Basis, d.h., es wird die Modellkennung zurückgegeben, die stimmt am besten mit der angegebenen
languageTag
überein. Dazu wird die folgende Heuristik verwendet:- Für das angeforderte Sprach-Subtag kann keine Modellkennung gefunden werden, Letzteres ist jedoch Teil einer unterstützten Makrosprache, Abgleich mit der Makrosprache, z.B.
"arb"
(Standard) Arabisch) entspricht"ar"
(Arabisch).- Wenn kein Skript angegeben und kein Skript für das angeforderte Sprach-Subtag implizit ist, stimmen Sie gegen jedes Skript.
- Wenn das angegebene oder implizite Skript-Subtag eine Teilmenge eines unterstützten Skripts ist, erfolgt der Abgleich mit auch Letzteres, z.B.
"zh-Hant"
(Chinesisch, Chinesisch, traditionell) spielt gegen"zh-Hani"
. (Chinesisch, Han).- Wenn kein untergeordnetes Tag für die Region angegeben ist, wird der Abgleich mit einer beliebigen Region durchgeführt, wobei Modellkennungen bevorzugt werden. die auch keine Region angeben, z.B.
"ro"
(Rumänisch) stimmt mit"ro-RO"
(Rumänisch, Rumänien).- Wenn ein untergeordnetes Tag für die Region angegeben ist, aber nicht abgeglichen werden kann, abgleichen Sie die Regionen mit dem angegebene Region, z.B.
"fr-DZ"
(Französisch, Algerien) spielt gegen"fr-002"
(Französisch, Afrika.Wenn keine Modellkennung gefunden wird, wird
nil
zurückgegeben.Erklärung
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierFromLanguageTag:(nonnull NSString *)languageTag error:(NSError *_Nullable *_Nullable)error;
Parameter
languageTag
Ein IETF BCP 47-Tag für die angeforderte Sprache.
error
Optionales Fehlermeldungsobjekt, wird ausgefüllt, wenn
languageTag
nicht möglich ist geparst.Rückgabewert
eine Modellkennung, die genau mit dem bereitgestellten Sprach-Tag übereinstimmt, oder die genaueste ungefähre Angabe oder
nil
, wenn keine entsprechende Modellkennung gefunden wird. Wird auch aufnil
festgelegt, wenn das Sprach-Tag konnte nicht geparst werden. - Für das angeforderte Sprach-Subtag kann keine Modellkennung gefunden werden, Letzteres ist jedoch Teil einer unterstützten Makrosprache, Abgleich mit der Makrosprache, z.B.
-
Gibt eine Modellkennung zurück, die genau mit dem angegebenen
languageTag
übereinstimmt.Unterscheidet sich von
from(LanguageTag:)
dadurch, dass nicht versucht wird,languageTag
zu parsen (und erzeugt somit keine Fehler) und gibt nur die Modellkennung zurück, die mitlanguageTag
genau, sofern vorhanden.Erklärung
Objective-C
+ (nullable MLKDigitalInkRecognitionModelIdentifier *) modelIdentifierForLanguageTag:(nonnull NSString *)languageTag;
Parameter
languageTag
Der IETF BCP 47-Sprachtag der angeforderten Modellkennung.
Rückgabewert
Eine
DigitalInkRecognitionModelIdentifier
, die genau mit der angegebenenlanguageTag
übereinstimmt, odernil
, wenn keiner gefunden wurde. -
Gibt die Gruppe aller verfügbaren Modellkennungen zurück.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) allModelIdentifiers;
-
Gibt die Gruppe der Modellkennungen zurück, die das angegebene Sprach-Subtag unterstützen
Beispiel: Für
"en"
wird ein Satz Modellkennungen zurückgegeben, dieenUs
enthalten. (Englisch, USA),enUk
(Englisch, Vereinigtes Königreich),enKe
(Englisch, Kenia) usw.Wenn keine Modellkennungen gefunden werden, die das Subtag für die Sprache unterstützen, wird ein leerer Satz zurückgegeben.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForLanguageSubtag:(nonnull NSString *)languageSubtag;
Parameter
languageSubtag
Ein zwei- oder dreistelliger ISO 639-Sprachcode, z.B.
"en"
für Englisch.Rückgabewert
Ein Satz von Modellkennungen, die die angegebene
languageSubtag
unterstützen, ist möglicherweise leer. -
Gibt die Gruppe der Modellkennungen zurück, die das angegebene Skript-Subtag unterstützen.
Beispiel: Für
"Latn"
wird eine Reihe von Modellkennungen zurückgegeben, dieenUs
(Englisch, USA),frFr
(Französisch, Frankreich),guLatn
(Gujarati, lateinische Schrift) usw.Diese Funktion gibt auch Modellkennungen zurück, die eine Obermenge des angegebenen Skripts unterstützen Subtag, z.B. Für
Hant
(Han, traditionelle Variante) gibt diese Funktion denzh-Hani
-Wert zurück. Erkennungsmodelle seitHant
ist eine Teilmenge vonHani
(Han, traditionelle und Vereinfachte Varianten).Wenn keine Modellkennungen gefunden werden, die das Skript-Subtag unterstützen, wird ein leerer Satz zurückgegeben.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForScriptSubtag:(nonnull NSString *)scriptSubtag;
Parameter
scriptSubtag
Ein aus vier Buchstaben bestehender ISO 15924-Standardcode, z.B.
"Latn"
für lateinische Schrift oder"Arab"
für arabisches Skript.Rückgabewert
Ein Satz von Modellkennungen, die die angegebene
scriptSubtag
unterstützen, ist möglicherweise leer. -
Gibt die Modellkennungen zurück, die für das angegebene Region-Subtag spezifisch sind
Beispiel: Für
"CH"
wird ein Satz Modellkennungen zurückgegeben, diedeCh
(Deutsch, Schweiz),frCh
(Französisch, Schweiz),itCh
(Italienisch, Schweiz) undrmCh
(Romanisch, Schweiz.Diese Funktion gibt auch Modellkennungen zurück, die für Regionen spezifisch sind, die das angegebene Dataset Subtag für Regionen oder im angegebenen Regions-Subtag enthalten, z.B. Suche nach
DZ
(Algerien) Ergebnisse, die das Erkennungsmodellfr-002
(Französisch, Afrika) und und umgekehrt.Wenn keine Modellkennungen gefunden werden, die das untergeordnete Tag für die Region unterstützen, wird ein leerer Satz zurückgegeben.
Erklärung
Objective-C
+ (nonnull NSSet<MLKDigitalInkRecognitionModelIdentifier *> *) modelIdentifiersForRegionSubtag:(nonnull NSString *)regionSubtag;
Parameter
regionSubtag
Ein aus zwei Buchstaben bestehender ISO 3166-1 Alpha 2-Standard-Regionscode oder einer der numerische Codes, die durch den UN M.49-Standard definiert sind, z.B.
"DE"
für Deutschland oder"002"
für Afrika.Rückgabewert
Eine Reihe von Modellkennungen, die für das angegebene
regionSubtag
spezifisch sind, können leer.