طرحواره فن

Nest Thermostat

sdm.devices.traits.Fan

این ویژگی متعلق به هر دستگاهی است که توانایی سیستم کنترل فن را داشته باشد.

فیلدها

میدان توضیحات نوع داده
timerMode حالت تایمر فعلی string
مقادیر: "روشن"، "خاموش"
timerTimeout مهر زمانی، در قالب RFC 3339، که در آن حالت تایمر به حالت OFF تبدیل می‌شود. string
مثال: "2019-05-10T03:22:54Z"

نمونه درخواست و پاسخ GET

درخواست کنید

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

پاسخ

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

دستورات

SetTimer

تایمر فن را عوض کنید

درخواست و پاسخ SetTimer

درخواست کنید

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

پاسخ

{}

فیلدهای درخواست SetTimer

میدان توضیحات نوع داده
timerMode حالت تنظیم تایمر فن. string
مقادیر: "روشن"، "خاموش"
duration اختیاری. مدت زمانی را که تایمر تنظیم شده است را بر حسب ثانیه مشخص می کند. string
محدوده: "1s" تا "43200s"
پیش‌فرض: "900s"

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

پیغام خطا RPC عیب یابی
فن ترموستات در دسترس نیست. FAILED_PRECONDITION ترموستات قابلیت فن ندارد. برای این دستگاه نمی توان از ویژگی ها و دستورات مربوط به فن استفاده کرد.

برای لیست کامل کدهای خطای API به مرجع کد خطای API مراجعه کنید.