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