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

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

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

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

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

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

חובה.

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

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

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

דוגמאות

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

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

דוגמאות

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

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

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

כאן מפורטת הרשימה המלאה של שגיאות וחריגים.