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

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

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

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