وحدات الماكرو

الماكرو هو برنامج JavaScript صغير يعمل محليًا على جهازك. على سبيل المثال، يمكنك برمجة جهازك للرد تلقائيًا على المكالمات الواردة من أرقام محددة.

يمكن لوحدات الماكرو تشغيل أوامر واجهة برمجة التطبيقات (API) لأجهزتك، وكذلك لأنظمة الجهات الخارجية.

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

يمكنك إدارة وحدات الماكرو من Control Hub أو Macro Editor على واجهة الويب الخاصة بالجهاز. لتكوين وحدات الماكرو من Control Hub، يجب عليك أولاً تمكين توفير وحدات الماكرو لأجهزتك.

في Control Hub، يمكنك رؤية التغييرات التي تم إجراؤها على وحدات الماكرو في محفوظات الجهاز.

امتدادات واجهة المستخدم

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

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

تتيح لك المنصة المفتوحة إنشاء عمليات تخصيص ترفق بتدفقات عملك الحالية؛ وبالتالي، تتيح لك إنشاء قيمة إضافية تتجاوز عرض Webex الأساسي.

تتضمن بعض الأمثلة ما يلي:

  • عرض بيانات خادم الويب المخصصة على الشاشة الرئيسية.

  • أبلغ عن المشكلات لنظام حجز التذاكر.

  • تجميع البيانات الصوتية من الغرفة وإرسالها إلى خادم ويب حيث يمكن رسمها.

  • التحكم في الأجهزة الطرفية التابعة لجهات خارجية، مثل الأضواء والستائر ومبدلات الفيديو.

يمكنك إنشاء امتدادات واجهة المستخدم من محرر امتدادات واجهة المستخدم في واجهة ويب الجهاز.

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

لتمكين توفير وحدات الماكرو، انتقل إلى الأجهزة > الإعدادات > وحدات الماكرو في Control Hub وقم بتشغيل السماح لـ Control Hub بإدارة وحدات الماكرو.


  • يتم تخزين جميع وحدات الماكرو في Control Hub وتشفيرها، ولكن ليس باستخدام المفتاح الخاص للعملاء، في سحابة Cisco. إذا كانت وحدات الماكرو الخاصة بك تحتوي على بيانات سرية، فيجب ألا تقوم بتمكين توفير وحدات الماكرو Control Hub.

  • ينطبق توفير Control Hub للوحدات الماكرو على أجهزة وضع المشاركة فقط.


يجب عليك أولاً تمكين توفير Control Hub للوحدات الماكرو كما هو موضح أعلاه.

يتم توفير توفير وحدات الماكرو على أساس جهاز واحد. لمشاركة وحدات الماكرو بين الأجهزة، يمكنك تنزيل وحدة ماكرو من جهاز واحد ثم تحميلها إلى جهاز آخر.

للوصول إلى وحدات الماكرو الخاصة بأجهزة وضع المشاركة:

  1. من عرض العميل في https://admin.webex.com، انتقل إلى الأجهزة وحدد الجهاز الذي تريد تكوينه.

  2. انتقل إلى التكوينات وحدد وحدات الماكرو.


لوحة وحدات الماكرو لأجهزة Control Hub

من هنا، يمكنك:

  • إنشاء وحدات ماكرو وتحريرها وحذفها.

  • تحميل وتنزيل وحدات الماكرو (*.js).

  • تمكين وحدات الماكرو أو تعطيلها.

  • احفظ التغييرات التي أجريتها.

  • عرض سجلات وحدات الماكرو.


إذا قام شخص ما بتحرير نفس الماكرو (وحدات الماكرو) من موقع ويب آخر في نفس الوقت، فسيتم تزويدك بخيارات لتنزيل نسخة من نسختك أو تجاهل نسختك أو الكتابة فوق الإصدار الآخر.

يوفر Macro Editor محرر الرموز وأدوات التسجيل وعناصر التحكم للاختبار السريع لوحدات الماكرو.


محرر وحدات الماكرو

سجّل الدخول إلى واجهة ويب الجهاز باستخدام بيانات اعتماد المسؤول وانتقل إلى التخصيص > Macro Editor. من هنا، يمكنك:

  • إنشاء وحدات ماكرو وتحريرها وحذفها.

  • استيراد أو تصدير وحدات الماكرو (*.js).

  • تمكين وحدات الماكرو أو تعطيلها.

  • مراجعة سجلات تصحيح الأخطاء.

  • احفظ التغييرات التي أجريتها (Ctrl+S)


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

يوفر محرر امتدادات واجهة المستخدم أدوات إنشاء:

  • أزرار الإجراءات - زر تمت إضافته إلى الصفحة الرئيسية. يمكن برمجة زر الإجراء لتنفيذ الإجراءات عندما ينقر المستخدم عليه.

  • اللوحات - يمكن أن تحتوي لوحة التحكم على العديد من عناصر واجهة المستخدم (على سبيل المثال، الأزرار، حقول النص، المحولات، الشرائح)، وكلها يمكن برمجتها لتنفيذ الإجراءات. يمكن أن يسمح لك هذا بدمج مجموعة عناصر التحكم الخاصة بك في موقع مشترك.

  • تطبيقات الويب - تم إضافة اختصار لتطبيق الويب إلى الصفحة الرئيسية. سيقوم تطبيق الويب بتشغيل صفحة ويب محددة مسبقًا في وضع ملء الشاشة. يتوفر هذا الخيار على جميع الأجهزة المزودة بمحرك ويب (مثل أجهزة سلسلة Board وDesk، باستثناء DX).

سجّل الدخول إلى واجهة ويب الجهاز باستخدام بيانات اعتماد Admin أو RoomControl أو المكامل وانتقل إلى التخصيص > Editor for UI Extensions.


محرر امتدادات واجهة المستخدم

من هنا، يمكنك:

  • أضف امتداد واجهة المستخدم أو تحميله أو تنزيله أو حذفه.

  • قم بإنشاء وتكوين العديد من أنواع عناصر التحكم.

  • قم بتعيين امتداد واجهة المستخدم على نشط مقابل غير نشط.

  • حدد متى يكون امتداد واجهة المستخدم مرئيًا.

  • قم بتصدير امتدادات UI الخاصة بك إلى جهاز الفيديو أو إلى ملف على الكمبيوتر الخاص بك.

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

للحصول على أمثلة توصيل امتدادات واجهة المستخدم بوحدات الماكرو، ارجع إلى هنا.

تعرَّف على المزيد حول إنشاء وحدات الماكرو وامتدادات واجهة المستخدم من:

تفضل بزيارة مجتمع مطوري التعاون Cisco إذا كنت تحتاج إلى مساعدة بشأن وحدات الماكرو ورمز جهة خارجية.

ارجع إلى تكوينات الأجهزة للغرفة وأجهزة المكتب ولوحات Webex للحصول على معلومات حول كيفية الوصول إلى واجهة الويب المحلية.