تطوير إضافة عرض

صفحة العرض والمعلمات

تتكون الإضافة من صفحة عرض ولوحة إعدادات اختيارية. تنتج اللوحة معلمات JSON تُرسل كـ vars وتُحفظ لكل منطقة. تستخدم الإضافة المسجلة name وإصداراً اختيارياً v. احصل على الهوية من خدمة المشروع؛ ويمكن للصفحات العامة استخدام web.

{"plugin":{"area":"a1","name":"<registered-plugin-id>","vars":{"label":"IoT Devices"}}}

قراءة البيانات واستقبال الأوامر

يحقن المشغّل window.superScreen قبل تنفيذ السكربتات، ويضم deviceId وarea وbench وversion وdata. اقرأ data عند البدء واستمع إلى superscreen للتحديثات. اعرض النص عبر textContent. تحتاج المتصفحات العادية إلى بيانات بديلة لغياب الجسر.

const title = document.querySelector("[data-screen-title]");
function render(data) {
  if (title) title.textContent = String(data?.label ?? "IoT Devices");
}
render(window.superScreen?.data);
window.addEventListener("superscreen", (event) => render(event.detail));

قدرات جسر الجهاز

• يستقبل SS.onCommand حمولة control.send. يرسل SS.report أحداث user بحد أقصى 30 في الدقيقة لكل جهاز. افحص النتيجة قبل افتراض التسليم.
• تتوفر SS.speech وSS.stopSpeech للنطق المحلي في صفحات الإضافات المستضافة محلياً، وليس صفحات الويب البعيدة. يعتمد العمل دون اتصال على الموارد المخزنة والبيانات الخارجية المطلوبة.
• اختبر الوضعين الأفقي والعمودي والمعلمات المفقودة وانقطاع الشبكة والاستعادة. استخدم موارد HTTPS وتجنب الاعتماد على تسجيل دخول تفاعلي.