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

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 מכשיר

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