تنتمي هذه السمة إلى أنواع الأجهزة من نوع THERMOSTAT التي يمكنها إرسال تفاصيل نظام التدفئة والتهوية وتكييف الهواء.
الحقول
الحقل
الوصف
نوع البيانات
status
حالة نظام التدفئة والتهوية وتكييف الهواء الحالية في الترموستات
string القيم: "إيقاف" أو "تدفئة" أو "تبريد"
توقيت الأحداث
يُرجى العِلم أنّه قد لا يتم إرسال حدث لتغيير حالة نظام التدفئة والتهوية وتكييف الهواء في الوقت نفسه الذي يتم فيه إرسال أحداث لتغيير وضع الترموستات.
على سبيل المثال، قد يحدث أحيانًا تأخير في بدء وضع التدفئة أو التبريد في الترموستات لحماية نظام التدفئة والتهوية وتكييف الهواء. في هذه الحالة، قد يؤدي تغيير وضع الترموستات في البداية إلى إرسال أحداث فقط لتغييرات السمة ThermostatMode و ThermostatTemperatureSetpoint ، مع إرسال تغيير السمة ThermostatHvac لاحقًا كحدث منفصل بعد تشغيل النظام فعليًا. في حال عدم حدوث تأخير في تشغيل نظام التدفئة والتهوية وتكييف الهواء، سيتم إرسال الأحداث الثلاثة في الوقت نفسه.
نموذج لطلب استرداد بيانات باستخدام GET والاستجابة له
تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eThermostatHvac\u003c/code\u003e trait applies to THERMOSTAT devices and provides information about their heating, ventilation, and air conditioning (HVAC) status.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003estatus\u003c/code\u003e field indicates the current HVAC mode of the thermostat, which can be "OFF", "HEATING", or "COOLING".\u003c/p\u003e\n"],["\u003cp\u003eEvents related to HVAC status changes might not always be delivered simultaneously with thermostat mode change events, potentially due to system protection delays.\u003c/p\u003e\n"],["\u003cp\u003eWhile you can retrieve the HVAC status using a GET request, there are no specific commands to control this trait directly.\u003c/p\u003e\n"]]],["The `ThermostatHvac` trait, applicable to THERMOSTAT devices, reports the current HVAC status, which can be \"OFF,\" \"HEATING,\" or \"COOLING.\" HVAC status change events might be delayed, occurring separately from thermostat mode or temperature setpoint changes. A GET request retrieves the device's HVAC status under the \"sdm.devices.traits.ThermostatHvac\" trait. No commands are available for this trait. Error codes are available for reference.\n"],null,["\u003cbr /\u003e\n\nThermostatHvac Schema\n=====================\n\n[Nest Thermostat](/nest/device-access/api/thermostat)\n\n`sdm.devices.traits.ThermostatHvac`\n\nThis trait belongs to device types of THERMOSTAT that can report HVAC details.\n\n\u003cbr /\u003e\n\nFields\n------\n\n\n| Field | Description | Data Type |\n|----------|----------------------------------------|----------------------------------------------|\n| `status` | Current HVAC status of the thermostat. | `string` Values: \"OFF\", \"HEATING\", \"COOLING\" |\n\n\u003cbr /\u003e\n\n### Timing of events\n\nNote that an event for a change in HVAC status may not be delivered at the same time as events\nfor a thermostat mode change.\n\nFor example, sometimes there is\n[a\ndelay in starting a thermostat's heating or cooling mode](https://support.google.com/googlenest/answer/9233450) in order to protect the HVAC\nsystem. In this scenario, changing the thermostat mode may only initially send events for\n[ThermostatMode](/nest/device-access/traits/device/thermostat-mode) and\n[ThermostatTemperatureSetpoint](/nest/device-access/traits/device/thermostat-temperature-setpoint) trait changes, with the\nThermostatHvac trait change sent later as a separate\nevent once the system actually turns on. If there was no delay in turning on the HVAC system, all\nthree events would be sent at the same time.\n\n\u003cbr /\u003e\n\n#### Sample GET request and response\n\n### Request\n\n```\nGET /enterprises/project-id/devices/device-id\n```\n\n### Response\n\n {\n \"name\" : \"enterprises/project-id/devices/device-id\",\n \"traits\" : {\n \"sdm.devices.traits.ThermostatHvac\" : {\n \"status\" : \"HEATING\"\n }\n }\n }\n\n\u003cbr /\u003e\n\nCommands\n--------\n\nThere are no commands available for this trait.\n\n\nErrors\n------\n\nSee the [API Error Code Reference](/nest/device-access/reference/errors/api) for\nthe full list of API error codes.\n\n\u003cbr /\u003e"]]
