دليل أجهزة الترموستات الذكية
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- نقاط درجة الحرارة في نطاق التدفئة والتبريد قريبة جدًا من بعضها.