دليل ترطيب الهواء للمنازل المزوّدة بأجهزة ذكية
action.devices.types.HUMIDIFIER
: أجهزة ترطيب الهواء هي أجهزة تضيف الرطوبة إلى الهواء. يمكن تفعيل هذه الميزة وإيقافها، والإبلاغ عن الرطوبة المستهدفة وضبطها، وقد تتوفّر أوضاع مختلفة للضبط أو إعدادات سرعة المروحة.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز "جهاز ترطيب الهواء" وبعض المرادفات ذات الصلة والأسماء المستعارة.
إمكانات الجهاز
يُرجى الرجوع إلى مستندات السمات المرتبطة للحصول على تفاصيل التنفيذ، مثل السمات والحالة التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والطلبات مطلوبة إذا كانت منطبقة على جهازك. إذا كان جهازك لا يوفّر هذه السمات، أدخِل رمز الخطأ functionNotSupported
في إحدى استجابة QUERY أو EXECUTE. راجِع
الأخطاء والاستثناءات للاطّلاع على مزيد من المعلومات.
السمات المقترحة
ننصحك باستخدام هذه السمات على جهازك، إذا كانت منطبقة. ومع ذلك، يمكنك الاختيار من بين جميع السمات المتاحة لك ومطابقتها مع وظائف منتجاتك الحالية على أفضل نحو.
-
action.devices.traits.FanSpeed
-
action.devices.traits.HumiditySetting
-
action.devices.traits.StartStop
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من أو يساوي 1000 ملي ثانية.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على جهاز: جهاز ترطيب الهواء بسيط
يتضمّن هذا القسم أمثلة على أحمال نيّة تمثّل "مرطب" شائعًا استنادًا إلى نوع الجهاز وسماته أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، عدِّل ردودك وفقًا لذلك لتعكس هذه التغييرات.
نموذج استجابة المزامنة
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.HUMIDIFIER", "traits": [ "action.devices.traits.FanSpeed", "action.devices.traits.HumiditySetting", "action.devices.traits.OnOff" ], "name": { "name": "Simple humidifier" }, "willReportState": true, "attributes": { "humiditySetpointRange": { "minPercent": 30, "maxPercent": 100 }, "availableFanSpeeds": { "speeds": [ { "speed_name": "low_key", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" }, { "speed_synonym": [ "Niedrig", "Schleppend" ], "lang": "de" } ] }, { "speed_name": "high_key", "speed_values": [ { "speed_synonym": [ "High" ], "lang": "en" }, { "speed_synonym": [ "Hoch" ], "lang": "de" } ] } ], "ordered": true } }, "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, "on": true, "currentFanSpeedSetting": "low_key", "humiditySetpointPercent": 50, "humidityAmbientPercent": 40 } } } }
نماذج أوامر EXECUTE
ضبط السرعة
للحصول على تفاصيل إضافية عن معلَمات الأوامر،
يُرجى الاطّلاع على
مرجع
action.devices.traits.FanSpeed
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "high_key" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentFanSpeedSetting": "high_key" } } ] } }
ضبط الرطوبة
للحصول على تفاصيل إضافية عن معلَمات الأوامر،
يُرجى الاطّلاع على
مرجع
action.devices.traits.HumiditySetting
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetHumidity", "params": { "humidity": 60 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "humiditySetpointPercent": 60, "humidityAmbientPercent": 40 } } ] } }
غير مفعّل
للحصول على تفاصيل إضافية عن معلَمات الأوامر،
يُرجى الاطّلاع على
مرجع
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }