الروبوتات — دليل المستخدم
الروبوتات — دليل المستخدم
ما هي الروبوتات؟
قسم الروبوتات في OrbitingFox يتيح لك التحكم في الأجهزة الخارجية — مثل a يد صناعية روبوتية أو أي جهاز آخر لديه واجهة برمجة تطبيقات ويب — مباشرة من متصفحك. تقوم بتسجيل الجهاز مرة واحدة، ثم تستخدم وحدة التحكم لإرسال الأوامر ورؤية النتائج في الوقت الحقيقي.
البدء
- اذهب إلى الروبوتات من قائمة التنقل (أو قم بزيارة
/robotics/). - انقر على إضافة واجهة برمجة تطبيقات الجهاز لتسجيل جهازك. ستحتاج إلى عنوان URL الخاص بالجهاز (الذي يقدمه من يدير خادم الجهاز).
- بعد الحفظ، انقر على فتح وحدة التحكم بجوار جهازك.
وحدة التحكم بالأوامر
تعتبر وحدة التحكم هي لوحة التحكم لجهاز واحد. تحتوي على ثلاثة أجزاء:
- أزرار مسبقة الإعداد — زر واحد لكل أمر مدعوم (مثل: فتح اليد، إغلاق اليد، قبضة الضغط). انقر على أي زر لإرسال ذلك الأمر على الفور.
- شريط الحالة — يُظهر ما يحدث الآن: جاهز، إرسال…، أو النتيجة (نجاح/خطأ). يوجد مؤقت مباشر يعد بينما الأمر قيد التنفيذ.
- سجل الأوامر — آخر 30 أمر أرسلته، مع رمز حالة HTTP، المصدر (وحدة التحكم/OrbitPilot)، الوقت، والمدَّة. انقر على أيقونة النسخ لنسخ السجل إلى الحافظة الخاصة بك.
إرسال أمر
- انقر على أي زر مسبق الإعداد (مثل: فتح اليد).
- يتحول شريط الحالة إلى اللون الكهرماني ويبدأ المؤقت. يتم تعطيل أزرار الإعداد المسبق بينما الأمر قيد التنفيذ.
- عندما تصل الاستجابة، يُظهر شريط الحالة علامة خضراء (نجاح) أو X حمراء (خطأ)، ومدة الوقت المنقضي.
- تتم إضافة النتيجة أيضًا إلى سجل الأوامر في أسفل الصفحة.
لماذا تستغرق بعض الأحيان وقتًا طويلاً؟
إذا كان الجهاز مستضافًا على خطة استضافة مجانية (مثل المستوى المجاني من Render)، فإنه يدخل في وضع السكون بعد 15 دقيقة من عدم النشاط. الأمر الأول بعد فترة السكون يقوم بإيقاظ الجهاز — قد يستغرق هذا من 30 إلى 50 ثانية. سيتحول المؤقت إلى اللون الكهرماني، ثم الأحمر، بينما تنتظر. الأوامر اللاحقة المرسلة خلال الـ 15 دقيقة التالية ستكون سريعة (عادة أقل من 1 ثانية).
سجل الأوامر
يتم حفظ كل أمر ترسله في السجل، سواء نجح أو فشل. يمكنك رؤية:
- اسم الأمر
- رمز حالة HTTP (200 = نجاح، 422 = أمر غير معروف، 500 = خطأ في الجهاز، إلخ.)
- المصدر (وحدة التحكم = قمت بالنقر على زر؛ OrbitPilot = أُرسل عبر مساعد AI)
- متى تم إرساله ومدة استغراقه (بالم milliseconds)
- أي رسالة خطأ من الجهاز
انقر على أيقونة النسخ في رأس السجل لنسخ السجل الكامل كنص عادي.
إدارة أجهزتك
من /robotics/ يمكنك:
- إضافة جهاز جديد عبر إضافة واجهة برمجة تطبيقات الجهاز
- تعديل جهاز (تغيير عنوان URL، قائمة الأوامر، إلخ.)
- إلغاء تنشيط جهاز حتى لا يظهر مرة أخرى في قائمة وحدة التحكم الخاصة بك (دون فقدان سجله)
This guide was translated automatically. Read the English original.