Documentation de référence sur MLKitTextRecognitionCommon Framework
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
TextRecognizer
class TextRecognizer : NSObject
Outil de reconnaissance de texte qui reconnaît le texte dans une image.
-
Renvoie un outil de reconnaissance de texte avec les options données.
Utilisation simultanée de plusieurs instances TextRecognizer
avec une langue différente
cette option n'est pas recommandée, car cela peut dégrader les performances.
Déclaration
Swift
class func textRecognizer(options: MLKCommonTextRecognizerOptions) -> Self
Paramètres
options
|
Options de configuration du programme de reconnaissance de texte.
|
Valeur renvoyée
Reconnaissance de texte configurée avec les options données.
-
Traite l'image donnée pour la reconnaissance de texte.
Paramètres
image
|
|
completion
|
Gestionnaire permettant de rappeler dans la file d'attente principale une fois la reconnaissance de texte terminée.
|
-
Renvoie le résultat de reconnaissance de texte dans l'image donnée ou nil
en cas d'erreur. Le texte
la reconnaissance est effectuée de manière
synchrone sur le thread appelant.
Nous vous recommandons d'appeler cette méthode en dehors du thread principal pour éviter de bloquer l'interface utilisateur. En tant que
résultat, une erreur NSException
est générée si cette méthode est appelée sur le thread principal.
Paramètres
image
|
Image dans laquelle vous souhaitez obtenir des résultats.
|
error
|
Paramètre d'erreur facultatif renseigné lorsqu'une erreur se produit lors de l'obtention des résultats.
|
Valeur renvoyée
Résultat de reconnaissance de texte dans l'image donnée ou nil
en cas d'erreur.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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."]]