طرحواره فن

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 مراجعه کنید.