مرجع إطار عمل MLKitDigitalInkRecognition
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
DigitalInkRecognizer
class DigitalInkRecognizer : NSObject
الاعتراض على التعرّف على الكتابة بخط اليد على الحبر الرقمي
الحبر الرقمي هو التمثيل المتجه لما كتبه المستخدم. وهو يتكون من تسلسل
من الخطوط، وكل منها عبارة عن سلسلة من نقاط الاتصال (الإحداثيات والطابع الزمني). يمكنك الاطّلاع على Ink
عن
التفاصيل.
-
-
بيان الإفصاح
Swift
class func digitalInkRecognizer(options: MLKDigitalInkRecognizerOptions) -> DigitalInkRecognizer
-
التعرف على حبر الإدخال.
يُرجى العِلم أنّ استخدام recognize(ink:context:completion:)
بدلاً من هذه الطريقة قد يؤدي إلى نتائج
الدقة في بعض الحالات.
بيان الإفصاح
Swift
func recognize(ink: MLKInk) async throws -> MLKDigitalInkRecognitionResult
المعلمات
ink
|
الإدخال المطلوب التعرّف عليه.
|
completion
|
|
-
التعرف على حبر الإدخال باستخدام سياق التعرف.
يحتوي سياق التعرف على معلومات حول حجم منطقة الكتابة والأحرف
التي تم إدخالها بالفعل في مربّع النص. وهذا يساعد في التمييز بين حالات معينة.
مثال على الاستخدام: نتج عن التعرّف السابق على السلسلة "hello"، التي تم إدراجها في
حقل النص. ثم يكتب المستخدم يدويًا "العالم". أرسِل إلى طريقة العرض الحالية الحبر الذي يشير إلى كلمة "العالم".
و"hello" كسلسلة في context
. من المرجح أن تعرض أداة التعرف السلسلة “ world”
مع وضع مسافة بادئة تفصل بين الكلمتين.
ولمزيد من التفاصيل، يمكنك الاطّلاع على DigitalInkRecognitionContext
.
بيان الإفصاح
Swift
func recognize(ink: MLKInk, context: MLKDigitalInkRecognitionContext) async throws -> MLKDigitalInkRecognitionResult
المعلمات
ink
|
الإدخال المطلوب التعرّف عليه.
|
context
|
|
completion
|
معاودة الاتصال للمرشحين الدائمين للحصول على التقدير. عرض
يمكنك DigitalInkRecognizerCallback للاطّلاع على التفاصيل. إذا لم يتم التعرف على أي شيء، فستجد قائمة فارغة
سيتم تمرير المرشحين إلى معاودة الاتصال.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eDigitalInkRecognizer\u003c/code\u003e is an object used for performing handwriting recognition on digital ink, which is a vector representation of user writing composed of strokes and touch points.\u003c/p\u003e\n"],["\u003cp\u003eIt is initialized using \u003ccode\u003edigitalInkRecognizer(options:)\u003c/code\u003e with specified options for customization.\u003c/p\u003e\n"],["\u003cp\u003eThe primary functions are \u003ccode\u003erecognize(ink:)\u003c/code\u003e and \u003ccode\u003erecognize(ink:context:)\u003c/code\u003e for performing handwriting recognition, with the latter allowing for a recognition context to improve accuracy.\u003c/p\u003e\n"],["\u003cp\u003eUsing a \u003ccode\u003eDigitalInkRecognitionContext\u003c/code\u003e with \u003ccode\u003erecognize(ink:context:)\u003c/code\u003e can provide better accuracy by considering the writing area and pre-existing text.\u003c/p\u003e\n"]]],[],null,["# MLKitDigitalInkRecognition Framework Reference\n\nDigitalInkRecognizer\n====================\n\n class DigitalInkRecognizer : NSObject\n\nObject to perform handwriting recognition on digital ink.\n\nDigital ink is the vector representation of what a user has written. It is composed of a sequence\nof strokes, each being a sequence of touch points (coordinates and timestamp). See [Ink](../Classes/Ink.html) for\ndetails.\n- `\n ``\n ``\n `\n\n ### [-init](#/c:objc(cs)MLKDigitalInkRecognizer(im)init)\n\n `\n ` \n Unavailable. Use [digitalInkRecognizer(options:)](../Classes/DigitalInkRecognizer.html#/c:objc(cs)MLKDigitalInkRecognizer(cm)digitalInkRecognizerWithOptions:) instead.\n- `\n ``\n ``\n `\n\n ### [digitalInkRecognizer(options:)](#/c:objc(cs)MLKDigitalInkRecognizer(cm)digitalInkRecognizerWithOptions:)\n\n `\n ` \n Creates a `DigitalInkRecognizer` object using the specified options.\n\n See [DigitalInkRecognizerOptions](../Classes/DigitalInkRecognizerOptions.html) for details. \n\n #### Declaration\n\n Swift \n\n class func digitalInkRecognizer(options: MLKDigitalInkRecognizerOptions) -\u003e DigitalInkRecognizer\n\n- `\n ``\n ``\n `\n\n ### [recognize(ink:)](#/c:objc(cs)MLKDigitalInkRecognizer(im)recognizeInk:completion:)\n\n `\n ` \n Performs a recognition of the input ink.\n\n Note that using `recognize(ink:context:completion:)` instead of this method may lead to better\n accuracy in some cases. \n\n #### Declaration\n\n Swift \n\n func recognize(ink: MLKInk) async throws -\u003e MLKDigitalInkRecognitionResult\n\n #### Parameters\n\n |--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | ` `*ink*` ` | Input to be recognized. |\n | ` `*completion*` ` | A callback for returning recognition candidates. See [DigitalInkRecognizerCallback](../Type-Definitions.html#/c:MLKDigitalInkRecognizer.h@T@MLKDigitalInkRecognizerCallback) for details. |\n\n- `\n ``\n ``\n `\n\n ### [recognize(ink:context:)](#/c:objc(cs)MLKDigitalInkRecognizer(im)recognizeInk:context:completion:)\n\n `\n ` \n Performs a recognition of the input ink using a recognition context.\n\n A recognition context contains information about the size of the writing area, and the characters\n that have already been entered in the text area. This helps disambiguate certain cases.\n\n Example usage: a previous recognition has yielded the string \"hello\", that has been inserted in a\n text field. The user then handwrites \"world\". Send the present method the ink showing \"world\",\n and \"hello\" as a string in `context`. The recognizer will most likely return the string \" world\"\n with a leading space separating the two words.\n\n See [DigitalInkRecognitionContext](../Classes/DigitalInkRecognitionContext.html) for details. \n\n #### Declaration\n\n Swift \n\n func recognize(ink: MLKInk, context: MLKDigitalInkRecognitionContext) async throws -\u003e MLKDigitalInkRecognitionResult\n\n #### Parameters\n\n |--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | ` `*ink*` ` | Input to be recognized. |\n | ` `*context*` ` | See [DigitalInkRecognitionContext](../Classes/DigitalInkRecognitionContext.html) for details. |\n | ` `*completion*` ` | A callback for returning recognition candidates. See [DigitalInkRecognizerCallback](../Type-Definitions.html#/c:MLKDigitalInkRecognizer.h@T@MLKDigitalInkRecognizerCallback) for details. If nothing can be recognized, an empty list of candidates will be passed to the callback. |"]]