סכימת תכונות של טיימר לבית חכם

action.devices.traits.Timer – תכונת הטיימר מייצגת טיימר במכשיר.

למשל, יכול להיות שבבקר חכם של ממטרה או מתג אור חכם יש טיימר מובנה. אפשר להשתמש בתכונה הזו כדי לשלוט בטיימר מובנה במכשירים, כמו למשל להתחיל טיימר חדש, להשהות ולבטל טיימר פועל, לשאול כמה זמן נותר.

מאפייני המכשיר

מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC. מידע נוסף על טיפול באובייקטים מסוג SYNC זמין במאמר מילוי אובייקטים של Intent.

מאפיינים	סוג	תיאור
maxTimerLimitSec	Integer	חובה. מציין את הגדרת הטיימר הארוכה ביותר שזמינה במכשיר, שנמדדת בשניות.
commandOnlyTimer	בוליאני	(ברירת המחדל: false) הערך הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (לא נכונה). יש להגדיר את המאפיין הזה כ-True אם המכשיר לא יכול להגיב ל-Intent QUERY או למצב דיווח של התכונה הזו.

דוגמאות

מכשיר עם טיימר של שעתיים.

{
  "maxTimerLimitSec": 7200
}

מכשיר STATES

ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים כחלק מהפעולה QUERY. מידע נוסף על טיפול באובייקטים מסוג QUERY זמין במאמר מילוי אובייקטים של Intent.

מדינות	סוג	תיאור
timerRemainingSec	Integer	חובה. הזמן הנוכחי שנותר בשניות, -1, או [0, maxTimerLimitSec]. יש להגדיר ל-1- כדי לציין שלא פועל טיימר.
timerPaused	בוליאני	הערך הוא True אם קיים טיימר פעיל אבל מושהה כרגע.

דוגמאות

כמה זמן נותר בטיימר של המכשיר? (לא פועל).

{
  "timerRemainingSec": -1
}

כמה זמן נותר בטיימר של המכשיר? (פועלת).

{
  "timerRemainingSec": 60
}

כמה זמן נותר בטיימר של המכשיר? (מושהה).

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

COMMANDS של מכשיר

מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE. מידע נוסף על טיפול באובייקטים מסוג EXECUTE זמין במאמר מילוי אובייקטים של Intent.

action.devices.commands.TimerStart

הפעלת טיימר חדש.

פרמטרים

פרמטרים	סוג	תיאור
timerTimeSec	Integer	חובה. משך הטיימר בשניות. חייב להיות בטווח של [1, maxTimerLimitSec].

דוגמאות

מפעילים את הטיימר של המכשיר למשך חמש דקות.

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

שגיאות קשורות

אירעה שגיאה בהפעלת הטיימר.

ערכים נתמכים:

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

משנים את משך הטיימר.

פרמטרים

פרמטרים	סוג	תיאור
timerTimeSec	Integer	חובה. כוונון חיובי או שלילי של הטיימר בשניות. חייב להיות בטווח של [-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

מכשיר ERRORS

כדאי לעיין ברשימה המלאה של שגיאות וחריגים.