دليل تعريشة المنزل المزوّد بأجهزة ذكية
action.devices.types.PERGOLA
- يمكن فتح وإغلاق العريشة (هيكل حديقة خارجية)، ويمكن أن تتم في أكثر من اتجاه. على سبيل المثال، قد تُفتَح بعض التعريشات التي تحتوي على لوحة إما إلى LEFT أو RIGHT.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز Pergola وبعض المرادفات والأسماء المستعارة ذات الصلة.
إمكانات الجهاز
ارجع إلى وثائق السمات المقابلة لتفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء استجابات EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة، إذا كانت سارية على جهازك. إذا كان جهازك لا يتيح استخدام هذه السمات، أدخِل رمز الخطأ
functionNotSupported
في استجابة QUERY أو EXECUTE. راجِع
الأخطاء والاستثناءات للاطّلاع على مزيد من المعلومات.
السمات المقترَحة
يُنصح باستخدام هذه السمات، إذا كانت سارية على جهازك. ومع ذلك، لك مطلق الحرية في المزج بين جميع السمات المتاحة ومطابقتها مع وظيفة المنتج الحالية على أفضل وجه.
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من 2500 ملي ثانية أو يساويه.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على الجهاز: تعريشة بسيطة
يحتوي هذا القسم على أمثلة على الحمولات المقصودة التي تمثل "التعريشة" الشائعة استنادًا إلى نوع الجهاز والسمات المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عليك تعديل إجاباتك وفقًا لذلك لتعكس هذه التغييرات.
نموذج استجابة المزامنة
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.PERGOLA", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple pergola" }, "willReportState": true, "attributes": { "openDirection": [ "LEFT", "RIGHT" ] }, "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": "LEFT" }, { "openPercent": 50, "openDirection": "RIGHT" } ] } } } }
نموذج أوامر 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": "LEFT" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "LEFT" }, { "openPercent": 50, "openDirection": "RIGHT" } ] } } ] } }