סכימה של תכונות טיימר לבית חכם
action.devices.traits.Timer
– תכונת הטיימר מייצגת טיימר במכשיר.
לדוגמה, יכול להיות שלבקר ממטרות חכם או מתג אור חכם יש טיימר מובנה. ניתן להשתמש בתכונה הזו כדי לשלוט בטיימר מובנה במכשירים כמו הפעלת טיימר חדש וגם השהיה וביטול של טיימר פועל, ובדיקת משך הזמן שנותר.
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
maxTimerLimitSec |
Integer |
חובה. מציין את הגדרת הטיימר הארוך ביותר הזמין במכשיר, שנמדד בשניות. |
commandOnlyTimer |
בוליאני |
(ברירת מחדל: מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת QUERY או למצב הדוח עבור התכונה הזו. |
דוגמאות
מכשיר עם מגבלת טיימר של שעתיים.
{ "maxTimerLimitSec": 7200 }
מצבים של המכשיר
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים
במסגרת הפעולה QUERY
. מידע נוסף על טיפול ב-QUERY
כוונות זמין בקטע מימוש כוונה.
מדינות | Type | תיאור |
---|---|---|
timerRemainingSec |
Integer |
חובה. הזמן שנותר בשניות, -1 או [0, |
timerPaused |
בוליאני |
הערך הוא True אם קיים טיימר פעיל אבל הוא מושהה כרגע. |
דוגמאות
כמה זמן נותר בטיימר של המכשיר? (לא פועל).
{ "timerRemainingSec": -1 }
כמה זמן נותר בטיימר של המכשיר? (פועל).
{ "timerRemainingSec": 60 }
כמה זמן נותר בטיימר של המכשיר? (מושהה).
{ "timerRemainingSec": 30, "timerPaused": true }
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-EXECUTE
כוונות זמין בקטע מימוש כוונה.
action.devices.commands.TimerStart
מפעילים טיימר חדש.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
timerTimeSec |
Integer |
חובה. משך הטיימר בשניות. חייב להיות בתוך [1, |
דוגמאות
הפעילו את הטיימר של המכשיר למשך חמש דקות.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
שגיאות קשורות
אירעה שגיאה בהפעלת הטיימר.
ערכים נתמכים:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
משנים את משך הטיימר.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
timerTimeSec |
Integer |
חובה. התאמה חיובית או שלילית של הטיימר. הערך חייב להיות בטווח של [ |
דוגמאות
הוספת דקה לטיימר של המכשיר.
{ "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
טיימר.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
להשהות את טיימר המכשיר.
{ "command": "action.devices.commands.TimerPause", "params": {} }
שגיאות קשורות
אירעה שגיאה בהשהיית הטיימר.
ערכים נתמכים:
noTimerExists
action.devices.commands.TimerResume
המשך הטיימר.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
הפעלת הטיימר של המכשיר.
{ "command": "action.devices.commands.TimerResume", "params": {} }
שגיאות קשורות
אירעה שגיאה בחידוש הטיימר.
ערכים נתמכים:
noTimerExists
action.devices.commands.TimerCancel
מבטלים את הטיימר.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
אין נכסים |
דוגמאות
עצירת טיימר המכשיר.
{ "command": "action.devices.commands.TimerCancel", "params": {} }
שגיאות קשורות
אירעה שגיאה בעצירת הטיימר.
ערכים נתמכים:
noTimerExists