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

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

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

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

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

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

חובה.

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

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

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

דוגמאות

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

{
  "maxTimerLimitSec": 7200
}

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה QUERY. למידה מידע נוסף על טיפול בכוונות של QUERY: מילוי Intent.

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

חובה.

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

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

דוגמאות

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

CommandS במכשיר

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

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

ERRORS במכשיר

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