طرح صفت تایمر خانه هوشمند

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

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

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

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

صفات تایپ کنید توضیحات
maxTimerLimitSec عدد صحیح

مورد نیاز.

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

commandOnlyTimer بولی

(پیش‌فرض: false )

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

نمونه ها

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

{
  "maxTimerLimitSec": 7200
}
 وضعیت دستگاه

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

ایالات تایپ کنید توضیحات
timerRemainingSec عدد صحیح

مورد نیاز.

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

timerPaused بولی

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

نمونه ها

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

{
  "timerRemainingSec": 30,
  "timerPaused": true
}
 دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

action.devices.commands.TimerStart

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

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

مورد نیاز.

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

نمونه ها

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

{
  "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
  }
}

30 ثانیه از تایمر دستگاه کم می کند.

{
  "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
خطاهای دستگاه لیست کامل خطاها و استثناها را ببینید.