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