طرحواره ویژگی تایمر خانه هوشمند

action.devices.traits.Timer - ویژگی Timer نشان دهنده یک تایمر روی یک دستگاه است.

برای مثال، یک کنترل‌کننده آب‌پاش هوشمند یا کلید برق هوشمند ممکن است دارای تایمر داخلی باشد. از این ویژگی می‌توان برای کنترل تایمر داخلی دستگاه‌ها، مانند شروع یک تایمر جدید و همچنین مکث و لغو یک تایمر در حال اجرا و پرسیدن اینکه چقدر زمان باقی مانده است، استفاده کرد.

ویژگی‌های دستگاه

دستگاه‌هایی که این ویژگی را دارند، ممکن است ویژگی‌های زیر را به عنوان بخشی از عملیات SYNC گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف SYNC ، به بخش «تحقق اهداف» مراجعه کنید.

ویژگی‌ها نوع توضیحات
maxTimerLimitSec عدد صحیح

الزامی است.

طولانی‌ترین زمان تنظیم‌شده‌ی موجود روی دستگاه را که بر حسب ثانیه اندازه‌گیری می‌شود، نشان می‌دهد.

حداقل مقدار: 1 .

commandOnlyTimer بولی

(پیش‌فرض: false )

نشان می‌دهد که آیا دستگاه از ارتباط یک‌طرفه (true) یا دوطرفه (false) پشتیبانی می‌کند یا خیر. اگر دستگاه نمی‌تواند به یک درخواست پرس‌وجو (QUERY intent) یا گزارش وضعیت (Report State) برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.

مثال‌ها

دستگاهی با محدودیت تایمر دو ساعته.

{
  "maxTimerLimitSec": 7200
}

وضعیت دستگاه

موجودیت‌هایی با این ویژگی ممکن است حالت‌های زیر را به عنوان بخشی از عملیات QUERY گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف QUERY ، به بخش «تحقق اهداف» مراجعه کنید.

ایالت‌ها نوع توضیحات
timerRemainingSec عدد صحیح

الزامی است.

زمان باقیمانده فعلی بر حسب ثانیه، -۱، یا [0، maxTimerLimitSec ]. برای نشان دادن اینکه هیچ تایمری در حال اجرا نیست، روی -۱ تنظیم کنید.

timerPaused بولی

اگر یک تایمر فعال وجود داشته باشد اما در حال حاضر متوقف شده باشد، صحیح است.

مثال‌ها

چقدر زمان از تایمر دستگاه باقی مانده است؟ (در حال اجرا نیست).

{
  "timerRemainingSec": -1
}

چقدر زمان از تایمر دستگاه باقی مانده است؟ (در حال اجرا).

{
  "timerRemainingSec": 60
}

چقدر زمان از تایمر دستگاه باقی مانده است؟ (مکث).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

دستورات دستگاه

دستگاه‌هایی که این ویژگی را دارند، می‌توانند به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف EXECUTE ، به بخش «تحقق اهداف» مراجعه کنید.

action.devices.commands.TimerStart

یک تایمر جدید را شروع کنید.

پارامترها

پارامترها نوع توضیحات
timerTimeSec عدد صحیح

الزامی است.

مدت زمان تایمر بر حسب ثانیه؛ باید در محدوده [1, maxTimerLimitSec ] باشد.

حداقل مقدار: 1 .

مثال‌ها

تایمر دستگاه را به مدت پنج دقیقه اجرا کنید.

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

خطایی در شروع تایمر رخ داده است.

مقادیر پشتیبانی شده:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

مدت زمان تایمر را تنظیم کنید.

پارامترها

پارامترها نوع توضیحات
timerTimeSec عدد صحیح

الزامی است.

تنظیم مثبت یا منفی تایمر بر حسب ثانیه؛ باید درون [ -maxTimerLimitSec , maxTimerLimitSec ] باشد.

مثال‌ها

یک دقیقه به تایمر دستگاه اضافه کنید.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

۳۰ ثانیه از تایمر دستگاه کم می‌کند.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

خطایی در تنظیم تایمر رخ داده است.

مقادیر پشتیبانی شده:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

تایمر مکث.

پارامترها

پارامترها نوع توضیحات

بدون ملک

مثال‌ها

تایمر دستگاه را متوقف کنید.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

هنگام مکث تایمر خطایی روی داد.

مقادیر پشتیبانی شده:

noTimerExists

action.devices.commands.TimerResume

تایمر از سرگیری.

پارامترها

پارامترها نوع توضیحات

بدون ملک

مثال‌ها

تایمر دستگاه را از سر بگیرید.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

خطایی در از سرگیری تایمر رخ داد.

مقادیر پشتیبانی شده:

noTimerExists

action.devices.commands.TimerCancel

تایمر را لغو کنید.

پارامترها

پارامترها نوع توضیحات

بدون ملک

مثال‌ها

تایمر دستگاه را متوقف کنید. 

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

هنگام متوقف کردن تایمر خطایی رخ داد.

مقادیر پشتیبانی شده:

noTimerExists

خطاهای دستگاه

لیست کامل خطاها و استثنائات را مشاهده کنید.