How to Use the API for the iAuto Automatic Writing Machine: A Simple Example

كيفية استخدام واجهة برمجة التطبيقات لآلة الكتابة الآلية iAuto: مثال بسيط

يدعم iAuto Automatic Writing Machine تكامل واجهة برمجة التطبيقات، مما يتيح للمطورين إرسال الأوامر والتحكم في الجهاز برمجيًا. يوضح هذا الدليل كيفية إجراء استدعاء أساسي لواجهة برمجة التطبيقات باستخدام أداة سطر الأوامر لبدء مهمة كتابة باستخدام ملف SVG. نزّل البرنامج مع مستند واجهة برمجة التطبيقات من هنا>>>

الخطوة 1: تحديد عنوان واجهة برمجة التطبيقات

تحديد عنوان واجهة برمجة التطبيقات

تأكد من اتصال الجهاز بشبكتك المحلية، وحدد عنوان IP والمنفذ الخاصين به. على سبيل المثال: http://192.168.1.XXX:90

استبدل XXX بجزء عنوان IP المحلي الصحيح لإعدادك.

تحديد عنوان واجهة برمجة التطبيقات

الخطوة 2: التعرّف على معلمات واجهة برمجة التطبيقات

التعرّف على معلمات واجهة برمجة التطبيقات

قبل إرسال الأوامر، تعرّف على المعلمات المطلوبة من واجهة برمجة التطبيقات. يوضح هذا المثال كتابة ملف SVG واحد. تتضمن هذه المعلمات ما يلي:

  • file: مسار ملف SVG المراد كتابته
  • width: عرض اللوحة (مثلًا، 210mm)
  • height: ارتفاع اللوحة (مثلًا، 297mm)
  • xpos: موضع البدء على المحور X
  • ypos: موضع البدء على المحور Y
  • scale: معامل التحجيم (القيمة الافتراضية هي 1)
  • rotation: زاوية الدوران بالدرجات (القيمة الافتراضية هي 0)
  • clear: ما إذا كان سيتم مسح المهمة السابقة (اضبطه على 1 للمسح)
  • start: ما إذا كان سيتم بدء المهمة فورًا (اضبطه على 1 لبدء الكتابة)

اطّلع على كود المصدر للحصول على أوصاف تفصيلية وأنواع الأخطاء

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

إليك مثالًا على أمر يرسل ملف SVG إلى الجهاز لبدء الكتابة فورًا:

curl -X POST ^
  -F "file=@\"F:\Desktop\concepts\tony.svg\"" ^
  -F "width=210mm" ^
  -F "height=297mm" ^
  -F "xpos=100mm" ^
  -F "ypos=100mm" ^
  -F "scale=1" ^
  -F "rotation=0" ^
  -F "clear=1" ^
  -F "start=1" ^
  http://192.168.1.XXX:90/write_svg

⚠️ تأكد من صحة مسار الملف المحدد وعنوان واجهة برمجة التطبيقات.

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

إذا نجح الطلب، فسيحمّل الجهاز ملف SVG ويبدأ الكتابة فورًا.

معاينة الواجهة

معاينة الواجهة

إذا حدث خطأ، فارجع إلى الملف المصدر لمعرفة سبب الخطأ.

بعد إدخال الأمر، تكون واجهة الجهاز كما يلي. سيستورد الجهاز صورة SVG تلقائيًا ويبدأ الكتابة تلقائيًا.

معاينة الواجهة

مثال على المخرجات

مثال على المخرجات

ملاحظات إضافية

  • يمكنك أيضًا استخدام واجهة برمجة التطبيقات بالتزامن مع لغات برمجة أخرى، مثل Python، لتحقيق مهام سير عمل أكثر تقدمًا أو مهام مؤتمتة.
  • مهم: تكامل واجهة برمجة التطبيقات مخصص للمطورين أو الفنيين. على الرغم من أننا نوفر واجهات برمجة التطبيقات وكود المصدر للرجوع إليه، فإن UUNA TEK لا تقدم دعمًا فنيًا لاستخدام واجهة برمجة التطبيقات المخصصة. يتم توفير منافذ واجهة برمجة التطبيقات فقط.
Back to blog

Leave a comment

Please note, comments need to be approved before they are published.