مخطط Thermostat ThermostatSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

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

الحقول

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

نموذج لطلب واستجابة GET - التدفئة

الطلب

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

الرد

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

نموذج لطلب واستجابة GET - رائع

الطلب

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
رائع SetCool coolCelsius
تدفئة 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 الحد الأقصى لدرجة الحرارة المُثلى الذي يتم ضبطه عندما يكون الترموستات في وضع "التبريد" number
مثال: 22.0

الأخطاء

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

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

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