دليل ستائر المنازل الذكية
action.devices.types.BLINDS
- يمكن فتح الستائر وإغلاقها، وتتوفّر أنواع مختلفة من الستائر، مثل النوافذ (الفتح في اتجاه واحد) واللوحة أو الوضع العمودي (يمكن أن تفتح إمّا لليسار أو لليمين) والأعلى من الأسفل للأسفل (قد يتم فتحها للأعلى أو للأسفل). قد تكون بعض الستائر مزوّدة بألواح يمكن تدويرها.
يشير هذا النوع إلى حصول الجهاز على رمز ستائر وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانات الجهاز
يُرجى الرجوع إلى مستندات السمات المرتبطة للحصول على تفاصيل التنفيذ، مثل السمات والحالة التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والطلبات مطلوبة إذا كانت منطبقة على جهازك. إذا كان جهازك لا يوفّر هذه السمات، أدخِل رمز الخطأ functionNotSupported
في إحدى استجابة QUERY أو EXECUTE. راجِع
الأخطاء والاستثناءات للاطّلاع على مزيد من المعلومات.
السمات المقترحة
ننصحك باستخدام هذه السمات على جهازك، إذا كانت منطبقة. ومع ذلك، يمكنك الاختيار من بين جميع السمات المتاحة لك ومطابقتها مع وظائف منتجاتك الحالية على أفضل نحو.
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من أو يساوي 2500 ملّي ثانية.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على جهاز: ستائر بسيطة
يحتوي هذا القسم على أمثلة لأحمال نيّة تمثّل "ستائر كهربائية" مشتركة بناءً على نوع الجهاز وسماته أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل ردودك وفقًا لذلك لتعكس هذه التغييرات.
في الجزء العلوي من أسفل لأسفل النافذة الميتلة، يرفع الاتجاه UP
الجزء السفلي من المكفوفين والعكسDOWN
، يؤدي إلى خفض الجزء العلوي من المكفوف. يعرض الشكل 1 مثالاً على ستارة علوية من الأعلى إلى الأسفل حيث يرفع اتجاه UP
الجزء السفلي من الستار بنسبة 50 في المئة وينخفض اتجاه DOWN
الجزء العلوي من الستار بنسبة 30 في المائة.

نموذج استجابة المزامنة
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BLINDS", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple blinds" }, "willReportState": true, "attributes": { "openDirection": [ "UP", "DOWN" ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
نموذج ردّ QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } } }
نماذج أوامر EXECUTE
OpenClose
للحصول على تفاصيل إضافية عن معلَمات الأوامر،
يُرجى الاطّلاع على
مرجع
action.devices.traits.OpenClose
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 10, "openDirection": "DOWN" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } ] } }