6.5.1 استخدام JSON

JSON
تدوين كائن JavaScript عبارة عن طريقة موحّدة لكتابة الأوامر أو البرامج الصغيرة من الأجهزة وإليها.
REST API
واجهة برمجة تطبيق نقل الحالة التمثيلية عبارة عن بروتوكول يتيح للأجهزة الأخرى التحكم في الأجهزة الأخرى بواسطة Encore3 أو التحكم في Encore3 مع الأجهزة الأخرى.
الموقع

Help (مساعدة) > Use JSON (استخدام JSON)

نبذة عن JSON

يتيح Encore3 التفاعل عن بُعد مع البرنامج من خلال استدعاءات واجهة برمجة التطبيقات في شكل طلبات JSON. يمكن إرسال هذه الطلبات بواسطة أنظمة مؤتمتة للتحكم أو جمع المعلومات حول Encore3. من الممكن اختبار هذه الأوامر واحدًا تلو الآخر للحصول على فهم أفضل لوظائف الأوامر.

ملاحظة: يجب تنفيذ هذه الاختبارات بواسطة الجهاز المطلوب للحصول على استجابة مناسبة. انتبه لحالة الجهاز والأمر الذي يتم اختباره.

يمكن حظر استدعاءات واجهة برمجة التطبيقات من خلال إعدادات الأمان الخاصة بـ Encore3. لمزيد من المعلومات، انظر:

نبذة عن وثائق الأوامر

ستتواصل جميع أجهزة Barco المطوّرة مع Event Master Toolset باستخدام REST API. لمزيد من المعلومات، راجع موقع Barco الإلكتروني:

كيفية إجراء الاختبار
  1. حدد أمرًا مطلوبًا (المرجع 2) من الفئة المطلوبة (المرجع 1) في القائمة الموجودة على اليسار. (اختياري)

    صورة 6–27
    1
    تحديد الفئة
    2
    تحديد الأوامر

    يتم إدخال الأمر في القائمة الموجودة على اليمين.

  2. هل عنوان IP (المرجع 8) صحيح؟

    • إذا كانت الإجابة بنعم، انتقل إلى الخطوة التالية.
    • إذا كانت الإجابة بلا، انقر فوق زر Clear IP Address (مسح عنوان IP) (المرجع 1) وأدخِل عنوان IP المطلوب (المرجع 8).
    تلميح: لمزيد من المعلومات حول كيفية العثور على عنوان IP، راجع “معرّف الوحدة، عنوان IP” أو “تهيئة الشبكة”.
    صورة 6–28
    1
    زر مسح عنوان IP
    2
    حقل إدخال الأمر المُدخل أو المحدد
    3
    زر مسح الأمر
    4
    تسمية رسالة الخطأ
    5
    تسمية استجابة الأمر
    6
    تسمية قيمة النجاح
    7
    زر إرسال الأمر
    8
    حقل إدخال عنوان IP
  3. قم بتعديل أو إدخال الأمر في حقل الإدخال بعد JSON Command (أمر JSON) (المرجع 2، صورة 6–28). (اختياري)

    تلميح: يمكن تغيير حجم نافذة الأوامر من خلال سحب الزاوية السفلية اليمنى من النافذة.
  4. انقر فوق Send Command (إرسال الأمر) (المرجع 7، صورة 6–28) لتشغيل الأمر.

    تتم طباعة نتائج الأمر في الحقل المقابل:

    • خطأ (المرجع 4، صورة 6–28)، تفاصيل الخطأ الذي حدث في الأمر.
    • تُظهر الاستجابة (المرجع 5، صورة 6–28)، ما يُرجعه الأمر.
    • تُظهر قيمة النجاح (المرجع 6، صورة 6–28)، ‘0’ إذا كان الأمر ناجحًا وليس له قيمة إرجاع.
  5. هل يجب اختبار الأوامر الأخرى؟

    • إذا كانت الإجابة بنعم ويجب اختبار أمر جديد، انقر فوق Clear Command (مسح الأمر) (المرجع 3، صورة 6–28) وانتقل إلى الخطوة 1.
    • إذا كانت الإجابة بنعم ويجب تعديل الأمر، انتقل إلى الخطوة 3.
    • إذا كانت الإجابة بلا، لا يلزم اتخاذ أي إجراءات أخرى.