חומר עזר בנושא MLKitTextRecognitionCommon Framework
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
TextRecognizer
class TextRecognizer : NSObject
כלי לזיהוי טקסט שמזהה טקסט בתמונה.
-
מחזירה את הכלי לזיהוי טקסט עם האפשרויות הנתונים.
שימוש בו-זמנית במספר מכונות של TextRecognizer עם שפה שונה
לא מומלץ, מכיוון שהיא עלולה להוביל לירידה בביצועים.
הצהרה
Swift
class func textRecognizer(options: MLKCommonTextRecognizerOptions) -> Self
פרמטרים
options
|
אפשרויות להגדרת מזהה הטקסט.
|
הערך המוחזר
מזהה טקסט שהוגדר עם האפשרויות הנתונות.
-
מתבצע עיבוד של התמונה הנתונה לצורך זיהוי טקסט.
פרמטרים
image
|
|
completion
|
מטפל כדי להתקשר חזרה לתור הראשי כשזיהוי הטקסט יסתיים.
|
-
מחזירה את תוצאת זיהוי הטקסט בתמונה הנתונה או את הערך nil אם הייתה שגיאה. הטקסט
הזיהוי מתבצע באופן סינכרוני בשרשור של הקריאה.
מומלץ להפעיל את השיטה הזו מחוץ ל-thread הראשי כדי למנוע חסימה של ממשק המשתמש. בתור
כתוצאה מכך, יועלה NSException אם מתבצעת קריאה לשיטה הזו בשרשור הראשי.
פרמטרים
image
|
התמונה שבה יתקבלו תוצאות.
|
error
|
פרמטר אופציונלי של שגיאה יאוכלס כשיש שגיאה בקבלת תוצאות.
|
הערך המוחזר
התוצאה של זיהוי הטקסט בתמונה הנתונה או הערך nil אם הייתה שגיאה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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."]]
