مخطط ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

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

الحقول

الحقل الوصف نوع البيانات
heatCelsius درجة الحرارة المستهدَفة بالدرجة المئوية لوضعَي التدفئة والتدفئة والتبريد في الترموستات number
مثال: 20.0
coolCelsius درجة الحرارة المستهدَفة بالدرجة المئوية لوضعَي التبريد والتدفئة والبرودة في الترموستات 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 ، يجب أن يكون الترموستات في وضع HEAT أولاً:

الوضع Command الحقول
HEAT SetHeat heatCelsius
بارد 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 الحد الأدنى لدرجة الحرارة المستهدَفة التي يمكن ضبطها عندما يكون الترموستات في وضع HEATCOOL number
مثال: 20.0
coolCelsius الحد الأقصى لدرجة الحرارة المستهدَفة التي يمكن ضبطها عندما يكون الترموستات في وضع HEATCOOL number
مثال: 22.0

الأخطاء

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

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

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