Riferimento per il framework comune MLKitTextRecognition
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
TextRecognizer
class TextRecognizer : NSObject
Un riconoscimento del testo che riconosce il testo in un'immagine.
-
Restituisce un riconoscimento del testo con le opzioni specificate.
Utilizzo simultaneo di più istanze TextRecognizer con lingua diversa
non è consigliato, poiché potrebbe portare a un peggioramento delle prestazioni.
Dichiarazione
Swift
class func textRecognizer(options: MLKCommonTextRecognizerOptions) -> Self
Parametri
options
|
Opzioni per la configurazione del riconoscimento del testo.
|
Valore restituito
Un riconoscimento del testo configurato con le opzioni specificate.
-
Elabora l'immagine fornita per il riconoscimento del testo.
Parametri
image
|
|
completion
|
Gestore da richiamare sulla coda principale al completamento del riconoscimento del testo.
|
-
Restituisce il risultato del riconoscimento del testo nell'immagine specificata o nil in caso di errore. Il testo
il riconoscimento viene eseguito in modo sincrono sul thread di chiamata.
Si consiglia di richiamare questo metodo dal thread principale per evitare di bloccare la UI. Come
risultato, viene generato un valore NSException se questo metodo viene chiamato sul thread principale.
Parametri
image
|
L'immagine in cui ottenere i risultati.
|
error
|
Parametro di errore facoltativo compilato quando si verifica un errore durante il recupero dei risultati.
|
Valore restituito
Risultato del riconoscimento del testo nell'immagine data o nil in caso di errore.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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."]]
