طرح صفت تایمر خانه هوشمند
action.devices.traits.Timer
- ویژگی Timer نشان دهنده یک تایمر در یک دستگاه است.
به عنوان مثال، یک کنترلر آبپاش هوشمند یا کلید چراغ هوشمند ممکن است یک تایمر داخلی داشته باشد. از این ویژگی می توان برای کنترل یک تایمر داخلی روی دستگاه ها استفاده کرد، مانند شروع یک تایمر جدید و همچنین توقف و لغو تایمر در حال اجرا، و پرسیدن اینکه چقدر زمان باقی مانده است.
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC
، به تحقق هدف مراجعه کنید.
ویژگی های | تایپ کنید | شرح |
---|---|---|
maxTimerLimitSec | عدد صحیح | ضروری. طولانی ترین تنظیم تایمر موجود در دستگاه را نشان می دهد که در ثانیه اندازه گیری می شود. |
commandOnlyTimer | بولی | (پیشفرض: نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید. |
مثال ها
دستگاه با محدودیت تایمر دو ساعته.
{ "maxTimerLimitSec": 7200 }
وضعیت دستگاه
موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY
، به تحقق هدف مراجعه کنید.
ایالت ها | تایپ کنید | شرح |
---|---|---|
timerRemainingSec | عدد صحیح | ضروری. زمان فعلی باقی مانده بر حسب ثانیه، -1 یا [0، |
timerPaused | بولی | درست است اگر تایمر فعال وجود داشته باشد اما در حال حاضر متوقف شده باشد. |
مثال ها
چقدر زمان روی تایمر دستگاه باقی مانده است؟ (در حال اجرا نیست).
{ "timerRemainingSec": -1 }
چقدر زمان روی تایمر دستگاه باقی مانده است؟ (دویدن).
{ "timerRemainingSec": 60 }
چقدر زمان روی تایمر دستگاه باقی مانده است؟ (مکث شد).
{ "timerRemainingSec": 30, "timerPaused": true }
دستورات دستگاه
دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE
پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE
intent ها، به اجرای Intent مراجعه کنید.
action.devices.commands.TimerStart
یک تایمر جدید شروع کنید.
مولفه های
مولفه های | تایپ کنید | شرح |
---|---|---|
timerTimeSec | عدد صحیح | ضروری. مدت زمان تایمر بر حسب ثانیه؛ باید در [1, |
مثال ها
تایمر دستگاه را به مدت پنج دقیقه اجرا کنید.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
خطاهای مرتبط
هنگام شروع تایمر خطایی روی داد.
مقادیر پشتیبانی شده:
-
noTimerExists
-
timerValueOutOfRange
-
aboveMaximumTimerDuration
-
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
مدت زمان تایمر را تنظیم کنید.
مولفه های
مولفه های | تایپ کنید | شرح |
---|---|---|
timerTimeSec | عدد صحیح | ضروری. تنظیم مثبت یا منفی تایمر در چند ثانیه. باید در [ |
مثال ها
یک دقیقه به تایمر دستگاه اضافه کنید.
{ "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