دليل الترموستات الذكي للمنزل
action.devices.types.THERMOSTAT: أجهزة الترموستات هي أجهزة لإدارة درجة الحرارة، وتتضمّن نقاط ضبط وأوضاعًا. ويفصل ذلك بينها وبين السخّانات ومكيّفات الهواء التي قد تتضمّن أوضاعًا وإعدادات فقط (على سبيل المثال، مرتفع/منخفض) بدلاً من درجة حرارة مستهدَفة.
يشير هذا النوع إلى أنّ الجهاز يحصل على رمز الترموستات وبعض المرادفات والأسماء المستعارة ذات الصلة.
تتحكّم الأجهزة من هذا النوع في درجة الحرارة، بينما تحتوي بعض وحدات التدفئة/التبريد في الغرف على عناصر تحكّم مختلفة وأوضاع عالية/منخفضة، ولكن ليس على عناصر تحكّم في درجة الحرارة.إمكانات الجهاز
راجِع مستندات السمة ذات الصلة للحصول على تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تدعمها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة إذا كانت تنطبق على جهازك. إذا كان جهازك لا يتوافق مع هذه السمات، أدخِل رمز الخطأ
functionNotSupported في رد QUERY أو EXECUTE. يمكنك الاطّلاع على الأخطاء والاستثناءات لمزيد من المعلومات.
يتم ربط أوامر الترموستات بشكل متكرّر في طلبات EXECUTE. سيؤدي قول المستخدم *أريد ضبط التدفئة على 72 درجة* إلى إنشاء أمر وضع متبوعًا بضبط درجة الحرارة.
مثال على جهاز: ترموستات بسيط
يحتوي هذا القسم على أمثلة على حمولات الأهداف التي تمثّل جهاز "ترموستات" شائعًا استنادًا إلى نوع الجهاز والسمات المذكورة أعلاه. في حال إضافة سمات أو إزالتها في عملية التنفيذ، يجب تعديل الردود وفقًا لذلك لعكس هذه التغييرات.
نموذج استجابة SYNC
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.THERMOSTAT", "traits": [ "action.devices.traits.TemperatureSetting" ], "name": { "name": "Simple thermostat" }, "willReportState": true, "attributes": { "availableThermostatModes": [ "off", "heat", "cool", "heatcool", "on" ], "thermostatTemperatureRange": { "minThresholdCelsius": 15, "maxThresholdCelsius": 30 }, "thermostatTemperatureUnit": "F" }, "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, "thermostatMode": "cool", "thermostatTemperatureSetpoint": 23, "thermostatTemperatureAmbient": 25.1, "thermostatHumidityAmbient": 45.3 } } } }
أمثلة على أوامر EXECUTE
ThermostatTemperatureSetpoint
للحصول على تفاصيل إضافية حول معلَمات الأمر، راجِع
مرجع action.devices.traits.TemperatureSetting.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatTemperatureSetpoint", "params": { "thermostatTemperatureSetpoint": 22 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "cool", "thermostatTemperatureSetpoint": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
ThermostatTemperatureSetRange
للحصول على تفاصيل إضافية حول معلَمات الأمر، راجِع
مرجع action.devices.traits.TemperatureSetting.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatTemperatureSetRange", "params": { "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22 } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "heatcool", "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
ThermostatSetMode
للحصول على تفاصيل إضافية حول معلَمات الأمر، راجِع
مرجع action.devices.traits.TemperatureSetting.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.ThermostatSetMode", "params": { "thermostatMode": "heatcool" } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "thermostatMode": "heatcool", "thermostatTemperatureSetpointHigh": 26, "thermostatTemperatureSetpointLow": 22, "thermostatTemperatureAmbient": 25.1 } } ] } }
أخطاء الجهاز
اطّلِع على القائمة الكاملة للأخطاء والاستثناءات.inHeatOrCool- تعذّر تنفيذ أوامر التدفئة/التبريد/النطاق لأنّ الجهاز في وضع التدفئة أو التبريد الصريح.inHeatCool- تعذّر تنفيذ أمرَي "تدفئة" أو "تبريد" لأنّ الجهاز في وضع التدفئة أو التبريد.lockedToRange- الجهاز مضبوط على نطاق درجة حرارة أو وضع معيّن، ولا يمكن إجراء التغيير المطلوب.rangeTooClose- نقاط درجة الحرارة في نطاق التدفئة والتبريد متقاربة جدًا.