دليل الستائر المنزلية الذكية
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" } ] } } } }
نماذج أوامر التنفيذ
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" } ] } } ] } }