مخطّط ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

تنتمي هذه السمة إلى أنواع أجهزة "الترموستات" التي تتيح ضبط درجة الحرارة المستهدفة ونطاق درجة الحرارة.

الحقول

الحقل الوصف نوع البيانات
heatCelsius درجة الحرارة المستهدَفة بالدرجة المئوية لوضعَي الترموستات HEAT وHEATCOOL number
مثال: 20.0
coolCelsius درجة الحرارة المستهدَفة بالدرجة المئوية لوضعَي الترموستات COOL وHEATCOOL number
مثال: 22.0

نموذج طلب GET والاستجابة له - HEAT

الطلب

GET /enterprises/project-id/devices/device-id

الرد

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

نموذج طلب GET والاستجابة - COOL

الطلب

GET /enterprises/project-id/devices/device-id

الرد

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

نموذج طلب GET والاستجابة - HEATCOOL

الطلب

GET /enterprises/project-id/devices/device-id

الرد

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

الطلبات الصوتية

يجب أن يكون الترموستات في الوضع المتوافق مع الطلب الذي يتم طلبه قبل تغيير درجات الحرارة المضبوطة. يختلف الأمر والحقول لتغيير نقاط ضبط الحرارة حسب وضع الترموستات .

على سبيل المثال، لإصدار الأمر SetHeat ، يجب أن يكون الترموستات في وضع التدفئة أولاً:

الوضع Command الحقول
الحرارة SetHeat heatCelsius
COOL SetCool coolCelsius
HEATCOOL SetRange heatCelsius، coolCelsius

يُرجى العِلم أنّ أوامر نقطة الضبط لا تقبل سوى الدرجات بالدرجة المئوية كمَعلمة، على الرغم من أنّ Google Nest Thermostat يمكنه عرض درجة الحرارة بالدرجة المئوية أو فهرنهايت.

SetHeat

لضبط درجة الحرارة المستهدَفة عندما يكون الترموستات في وضع "التدفئة".

طلب SetHeat والاستجابة

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

الرد

{}

حقول طلب SetHeat

الحقل الوصف نوع البيانات
heatCelsius درجة الحرارة المستهدَفة التي يتم ضبطها عندما يكون الترموستات في وضع "التدفئة" number
مثال: 22.0

SetCool

يضبط درجة الحرارة المُثلى عندما يكون الترموستات في وضع "التبريد".

طلب واستجابة SetCool

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

الرد

{}

حقول طلب SetCool

الحقل الوصف نوع البيانات
coolCelsius درجة الحرارة المستهدَفة التي يتم ضبطها عندما يكون الترموستات في وضع "التبريد" number
مثال: 20.0

SetRange

يتم ضبط الحد الأدنى والأقصى لدرجات الحرارة عندما يكون الترموستات في وضع "التدفئة" (HEATCOOL).

طلب SetRange والاستجابة

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

الرد

{}

حقول طلب SetRange

الحقل الوصف نوع البيانات
heatCelsius الحد الأدنى لدرجة الحرارة المُثلى الذي يتم ضبطه عندما يكون الترموستات في وضع "التبريد" number
مثال: 20.0
coolCelsius الحد الأقصى لدرجة الحرارة المستهدفة التي يتم ضبطها عندما يكون الترموستات في وضع HEATCOOL number
مثال: 22.0

الأخطاء

قد يتم عرض رموز الخطأ التالية في ما يتعلّق بهذه السمة:

رسالة الخطأ متوسط عائد النقرة تحديد المشاكل وحلّها
لا يُسمح بهذا الطلب في وضع الترموستات الحالي. FAILED_PRECONDITION لا تتيح بعض طُرز الترموستات تغيير وضع "توفير الطاقة" عندما يكون وضع الترموستات "غير مفعّل"، وذلك وفقًا لسمة ThermostatMode . يجب تغيير وضع الترموستات إلى "التدفئة" أو "التبريد" أو "التدفئة" قبل تغيير وضع "درجات حرارة اقتصادية".
يجب أن تكون قيمة "التبريد" أكبر من قيمة "التدفئة". INVALID_ARGUMENT تأكَّد من أنّ الحقل heatCelsius أقل من الحقل coolCelsius في الأمر.
لا يُسمح بهذا الأمر عندما يكون الترموستات في وضع MANUAL_ECO. FAILED_PRECONDITION لا يمكن ضبط درجة الحرارة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي.

اطّلِع على مرجع رموز الخطأ في واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز الخطأ في واجهة برمجة التطبيقات.