التكامل السحابي والمحلي

اختيار قناة الاتصال

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

تحمل الرسائل mid من ثمانية أحرف وطابعاً زمنياً بالمللي ثانية ts. تحتفظ الردود بالمعرّف الأصلي. اربط به الطلبات والردود والأحداث؛ فالإقرار لا يثبت ظهور المحتوى على الشاشة.

{"device":123,"mid":"ab12cd34","data":{"screen":{"action":"list"}},"ts":1793664000000}

الاتصال عبر الشبكة المحلية

يحاول المشغّل المنفذ 9756 ثم المنافذ التسعة التالية عند انشغاله. يعرض GET /ping المنفذ الفعلي. يُفضّل WebSocket /order؛ ويبقى POST /order للتوافق القديم. الرمز المحلي هو رمز الجهاز من ستة أرقام؛ والرمز الفارغ أو المعطل يمنع هذا الوصول.

• يمكن للعملاء الأصليين استخدام ترويسات X-SS-Token وX-SS-Remote-Id وX-SS-Remote-Name. احفظ الرمز سرياً ولا تعرض المنفذ المحلي للإنترنت العام.
• لا تفترض أن صفحة HTTPS يمكنها الوصول إلى HTTP أو WS محلي غير مشفر؛ تنطبق قيود المحتوى المختلط. استخدم التطبيق المقدم أو خدمة محلية مناسبة. تقتصر أوامر system المحلية على info وreg.

GET http://<device-ip>:<port>/ping
ws://<device-ip>:<port>/order?token=<control-code>&rid=<remote-id>&rname=<remote-name>

{"mid":"ab12cd34","data":{"screen":{"action":"list"}},"ts":1793664000000}

الردود والأخطاء

تعيد الإجراءات الناجحة ret: ok، وقد تعيد الاستعلامات البيانات مباشرة. يعيد الفشل ret: error وmsg. تشمل الأخطاء invalid param وinvalid state وunsupported وqueue full وdevice is in remote mode. تحقق من الحالة قبل إعادة إجراء مجهول النتيجة.

{"mid":"ab12cd34","ret":"ok"}
{"mid":"ab12cd34","ret":"error","msg":"unsupported"}