إرسال بيانات الحبر إلى واجهة برمجة تطبيقات Ink Recognizer

  • مقالة

ملاحظة

انتهت معاينة واجهة برمجة تطبيقات Ink Recognizer في 26 أغسطس 2020. إذا كان لديك موارد Ink Recognizer موجودة، يمكنك الاستمرار في استخدامها حتى يتم إيقاف الخدمة بالكامل في 31 يناير 2021.

يشير الكتابة بالحبر الرقمي إلى التقنيات التي تمكن التمثيلات الرقمية للإدخل مثل الكتابة اليدوية والرسومات. يتم تحقيق ذلك عادة باستخدام جهاز رقمي يلتقط حركات أجهزة الإدخال، مثل قلم. مع استمرار الأجهزة في تمكين تجارب الكتابة بالحبر الرقمي الغنية، يتيح الذكاء الاصطناعي والتعلم الآلي التعرف على الأشكال والنصوص المكتوبة في أي سياق. تمكنك واجهة برمجة تطبيقات Ink Recognizer من إرسال ضغطات الحبر والحصول على معلومات مفصلة عنها.

واجهة برمجة تطبيقات التعرف على الحبر مقابل خدمات التعرف البصري على الحروف

لا تستخدم واجهة برمجة تطبيقات Ink Recognizer التعرف البصري على الأحرف (OCR). تعالج خدمات التعرف البصري على الحروف بيانات البكسل من الصور لتوفير الكتابة اليدوية والتعرف على النص. يسمى هذا أحيانا التعرف دون اتصال. بدلا من ذلك، تتطلب واجهة برمجة تطبيقات Ink Recognizer بيانات ضغطة الحبر الرقمية التي يتم التقاطها أثناء استخدام جهاز الإدخال. يمكن أن تؤدي معالجة بيانات الحبر الرقمي بهذه الطريقة إلى نتائج التعرف الأكثر دقة مقارنة بخدمات التعرف البصري على الحروف.

إرسال بيانات الحبر

تتطلب واجهة برمجة تطبيقات Ink Recognizer إحداثيات X وY التي تمثل ضغطات الحبر التي تم إنشاؤها بواسطة جهاز إدخال، من اللحظة التي تلمس فيها سطح الكشف إلى وقت رفعه. يجب أن تكون نقاط كل ضغطة سلسلة من القيم المفصولة بفواصل، وأن يتم تنسيقها في JSON مثل المثال أدناه. بالإضافة إلى ذلك، يجب أن يكون لكل ضغطة حبر معرف فريد في كل طلب. إذا تم تكرار المعرف ضمن نفس الطلب، فسترجع واجهة برمجة التطبيقات خطأ. للحصول على نتائج التعرف الأكثر دقة، لديك ثمانية أرقام على الأقل بعد الفاصلة العشرية. يفترض أن أصل (0,0) من اللوحة هو الزاوية العلوية اليمنى من لوحة الكتابة بالحبر.

ملاحظة

المثال التالي غير صالح JSON. يمكنك العثور على طلب Ink Recognizer JSON كامل على GitHub.

{
  "language": "en-US",
  "strokes": [
   {
    "id": 43,
    "points": 
        "5.1365, 12.3845,
        4.9534, 12.1301,
        4.8618, 12.1199,
        4.7906, 12.2217,
        4.7906, 12.5372,
        4.8211, 12.9849,
        4.9534, 13.6667,
        5.0958, 14.4503,
        5.3299, 15.2441,
        5.6555, 16.0480,
        ..."
   },
    ...
  ]
}

استجابة Ink Recognizer

ترجع واجهة برمجة تطبيقات Ink Recognizer استجابة تحليل حول الكائنات التي تعرفت عليها من محتوى الحبر. تحتوي الاستجابة على وحدات التعرف التي تصف العلاقات بين ضغطات الحبر المختلفة. على سبيل المثال، سيتم تضمين الضغطات التي تنشئ أشكالا منفصلة متميزة بوحدات مختلفة. تحتوي كل وحدة على معلومات مفصلة حول ضغطات الحبر الخاصة بها بما في ذلك الكائن الذي تم التعرف عليه وإحداثياته وسمات الرسم الأخرى.

الأشكال التي تم التعرف عليها بواسطة واجهة برمجة تطبيقات Ink Recognizer

يمكن لواجهة برمجة تطبيقات Ink Recognizer تحديد الأشكال الأكثر استخداما في تدوين الملاحظات. تعرض الصورة أدناه بعض الأمثلة الأساسية. للحصول على قائمة كاملة بالأشكال ومحتوى الحبر الآخر الذي تعرفت عليه واجهة برمجة التطبيقات، راجع مقالة مرجع واجهة برمجة التطبيقات.

قائمة الأشكال التي تم التعرف عليها بواسطة واجهة برمجة تطبيقات Ink Recognizer

يمكنك استدعاء واجهة برمجة تطبيقات REST ل Ink Recognizer بأنماط مختلفة وفقا لتطبيقك.

استدعاءات واجهة برمجة التطبيقات التي بدأها المستخدم

إذا كنت تقوم بإنشاء تطبيق يأخذ إدخال المستخدم (على سبيل المثال، تطبيق تدوين ملاحظات أو تعليق توضيحي)، فقد ترغب في منحه التحكم في وقت إرسال الحبر وأيهما يتم إرساله إلى واجهة برمجة تطبيقات Ink Recognizer. تكون هذه الوظيفة مفيدة بشكل خاص عندما يكون النص والأشكال موجودين على اللوحة، ويرغب المستخدمون في تنفيذ إجراءات مختلفة لكل منها. ضع في اعتبارك إضافة ميزات التحديد (مثل lasso أو أداة تحديد هندسية أخرى) التي تمكن المستخدمين من اختيار ما يتم إرساله إلى واجهة برمجة التطبيقات.

استدعاءات واجهة برمجة التطبيقات التي بدأها التطبيق

يمكنك أيضا استدعاء تطبيقك لواجهة برمجة تطبيقات Ink Recognizer بعد انتهاء المهلة. من خلال إرسال ضغطات الحبر الحالية إلى واجهة برمجة التطبيقات بشكل روتيني، يمكنك تخزين نتائج التعرف أثناء إنشائها مع تحسين وقت استجابة واجهة برمجة التطبيقات. على سبيل المثال، يمكنك إرسال سطر من النص المكتوب بخط اليد إلى واجهة برمجة التطبيقات بعد اكتشاف أن المستخدم قد أكمله.

يمنحك الحصول على نتائج التعرف مسبقا معلومات حول خصائص ضغطات الحبر من حيث صلتها ببعضها البعض. على سبيل المثال، الضغطات التي يتم تجميعها لتشكيل نفس الكلمة أو السطر أو القائمة أو الفقرة أو الشكل نفسه. يمكن لهذه المعلومات تحسين ميزات تحديد الحبر لتطبيقك من خلال القدرة على تحديد مجموعات من الضغطات في وقت واحد، على سبيل المثال.

دمج واجهة برمجة تطبيقات Ink Recognizer مع Windows Ink

يوفر Windows Ink أدوات وتقنيات لتمكين تجارب الكتابة بالحبر الرقمي على مجموعة متنوعة من الأجهزة. يمكنك دمج النظام الأساسي Windows Ink مع واجهة برمجة تطبيقات Ink Recognizer لإنشاء تطبيقات تعرض ضغطات الحبر الرقمي وتفسرها.

الخطوات التالية