MLKitTextRecognition Common Framework-Referenz
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
TextRecognizer
class TextRecognizer : NSObject
Eine Texterkennung, die Text in einem Bild erkennt.
-
Gibt eine Texterkennung mit den angegebenen Optionen zurück.
Gleichzeitige Nutzung mehrerer TextRecognizer-Instanzen mit unterschiedlicher Sprache
-Optionen wird nicht empfohlen, da dies zu Leistungseinbußen führen kann.
Erklärung
Swift
class func textRecognizer(options: MLKCommonTextRecognizerOptions) -> Self
Parameter
options
|
Optionen zum Konfigurieren der Texterkennung.
|
Rückgabewert
Eine Texterkennung, die mit den angegebenen Optionen konfiguriert ist.
-
Verarbeitet das angegebene Bild zur Texterkennung.
Parameter
image
|
Das zu verarbeitende Bild.
|
completion
|
Handler für den Rückruf für die Hauptwarteschlange, wenn die Texterkennung abgeschlossen ist.
|
-
Gibt das Ergebnis der Texterkennung im angegebenen Bild oder nil zurück, wenn ein Fehler aufgetreten ist. Der Text
-Erkennung wird synchron für den aufrufenden Thread durchgeführt.
Es wird empfohlen, diese Methode aus dem Hauptthread aufzurufen, damit die Benutzeroberfläche nicht blockiert wird. Als
wird ein NSException ausgegeben, wenn diese Methode im Hauptthread aufgerufen wird.
Parameter
image
|
Das Bild, in dem Ergebnisse abgerufen werden sollen.
|
error
|
Ein optionaler Fehlerparameter, der ausgefüllt wird, wenn beim Abrufen der Ergebnisse ein Fehler auftritt.
|
Rückgabewert
Ergebnis der Texterkennung im angegebenen Bild oder nil, wenn ein Fehler aufgetreten ist.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[[["\u003cp\u003e\u003ccode\u003eTextRecognizer\u003c/code\u003e identifies and extracts text within images.\u003c/p\u003e\n"],["\u003cp\u003eIt offers both synchronous and asynchronous processing options.\u003c/p\u003e\n"],["\u003cp\u003eConcurrent use with varying language settings may impact performance.\u003c/p\u003e\n"],["\u003cp\u003eDirect use on the main thread is discouraged due to potential UI blocking.\u003c/p\u003e\n"]]],["The `TextRecognizer` class recognizes text in images. It can be initialized with specific options via `textRecognizer(options:)`. The `process(_:)` method performs text recognition on an image asynchronously, while `results(in:)` performs it synchronously, returning the recognized text or `nil` if an error occurs. Concurrent usage of multiple `TextRecognizer` instances with different language options may reduce performance. `results(in:)` should not be called on the main thread.\n"],null,["# MLKitTextRecognitionCommon Framework Reference\n\nTextRecognizer\n==============\n\n class TextRecognizer : NSObject\n\nA text recognizer that recognizes text in an image.\n- `\n ``\n ``\n `\n\n ### [textRecognizer(options:)](#/c:objc(cs)MLKTextRecognizer(cm)textRecognizerWithOptions:)\n\n `\n ` \n Returns a text recognizer with the given options.\n\n Concurrent usage of multiple `TextRecognizer` instances with different language\n options is not recommended, since it may lead to performance degradation. \n\n #### Declaration\n\n Swift \n\n class func textRecognizer(options: MLKCommonTextRecognizerOptions) -\u003e Self\n\n #### Parameters\n\n |-----------------|----------------------------------------------|\n | ` `*options*` ` | Options for configuring the text recognizer. |\n\n #### Return Value\n\n An text recognizer configured with the given options.\n- `\n ``\n ``\n `\n\n ### [process(_:)](#/c:objc(cs)MLKTextRecognizer(im)processImage:completion:)\n\n `\n ` \n Processes the given image for text recognition. \n\n #### Declaration\n\n Swift \n\n func process(_ image: ../Protocols.html#/c:objc(pl)MLKCompatibleImage) async throws -\u003e MLKText\n\n #### Parameters\n\n |--------------------|-------------------------------------------------------------------------|\n | ` `*image*` ` | The image to process. |\n | ` `*completion*` ` | Handler to call back on the main queue when text recognition completes. |\n\n- `\n ``\n ``\n `\n\n ### [results(in:)](#/c:objc(cs)MLKTextRecognizer(im)resultsInImage:error:)\n\n `\n ` \n Returns text recognition result in the given image or `nil` if there was an error. The text\n recognition is performed synchronously on the calling thread.\n\n It is advised to call this method off the main thread to avoid blocking the UI. As a\n result, an `NSException` is raised if this method is called on the main thread. \n\n #### Declaration\n\n Swift \n\n func results(in image: ../Protocols.html#/c:objc(pl)MLKCompatibleImage) throws -\u003e MLKText\n\n #### Parameters\n\n |---------------|-------------------------------------------------------------------------------|\n | ` `*image*` ` | The image to get results in. |\n | ` `*error*` ` | An optional error parameter populated when there is an error getting results. |\n\n #### Return Value\n\n Text recognition result in the given image or `nil` if there was an error."]]
