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

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

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

ATTRIBUTES במכשיר

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

מאפיינים Type תיאור
maxTimerLimitSec Integer

חובה.

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

commandOnlyTimer בוליאני

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

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

דוגמאות

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

{
  "maxTimerLimitSec": 7200
}

מצבים של המכשיר

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

מדינות Type תיאור
timerRemainingSec Integer

חובה.

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

timerPaused בוליאני

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

דוגמאות

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

פקודות מכשיר

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

action.devices.commands.TimerStart

מפעילים טיימר חדש.

פרמטרים

פרמטרים Type תיאור
timerTimeSec Integer

חובה.

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

דוגמאות

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

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

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

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

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

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

פרמטרים

פרמטרים Type תיאור
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

טיימר.

פרמטרים

פרמטרים Type תיאור

אין נכסים

דוגמאות

להשהות את טיימר המכשיר.

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

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

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

noTimerExists

action.devices.commands.TimerResume

המשך הטיימר.

פרמטרים

פרמטרים Type תיאור

אין נכסים

דוגמאות

הפעלת הטיימר של המכשיר.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

אירעה שגיאה בחידוש הטיימר.

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

noTimerExists

action.devices.commands.TimerCancel

מבטלים את הטיימר.

פרמטרים

פרמטרים Type תיאור

אין נכסים

דוגמאות

עצירת טיימר המכשיר.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

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

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

noTimerExists

ERRORS מכשיר

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