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

‫action.devices.traits.Timer – מאפיין Timer מייצג טיימר במכשיר.

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

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

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

מאפיינים סוג תיאור
maxTimerLimitSec Integer

חובה.

מציין את הגדרת הטיימר הארוכה ביותר שזמינה במכשיר, שנמדדת בשניות.

ערך מינימלי: 1.
commandOnlyTimer בוליאני

(ברירת מחדל: false)

מציין אם המכשיר תומך בשימוש בתקשורת חד-כיוונית (true) או דו-כיוונית (false). מגדירים את המאפיין הזה כ-True אם המכשיר לא יכול להגיב לאינטנט QUERY או ל-Report State עבור התכונה הזו.

דוגמאות

מכשיר עם מגבלת זמן של שעתיים בטיימר.

{
  "maxTimerLimitSec": 7200
}

מצבי המכשיר

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

מדינות סוג תיאור
timerRemainingSec Integer

חובה.

הזמן הנוכחי שנותר בשניות, ‎-1 או [0, maxTimerLimitSec]. הערך ‎-1 מציין שלא מופעל טיימר.
timerPaused בוליאני

הערך הוא True אם קיים טיימר פעיל אבל הוא מושהה כרגע.

דוגמאות

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

פקודות למכשיר

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

action.devices.commands.TimerStart

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

פרמטרים

פרמטרים סוג תיאור
timerTimeSec Integer

חובה.

משך הטיימר בשניות. הערך חייב להיות בטווח [1, maxTimerLimitSec].

ערך מינימלי: 1.

דוגמאות

‫Run device timer for five minutes.

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

שגיאות במכשיר

רשימה מלאה של שגיאות וחריגים