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

action.devices.traits.LightEffects – המאפיין הזה שייך למכשירים שיכולים לתמוך בפקודות מורכבות של תאורה כדי לשנות את המצב, כמו לולאה של צבעים שונים.

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

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

דוגמאות

מכשיר שתומך באפקט של לולאת צבעים.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

מכשיר שתומך באפקטים של מצב שינה/התעוררות

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

מצבי המכשיר

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

דוגמאות

מהי ההשפעה הנוכחית על המכשיר שלי?

{
  "activeLightEffect": "colorLoop"
}

מהי ההשפעה הנוכחית על המכשיר שלי?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

אין אפקט תאורה פעיל כרגע.

{}

פקודות למכשיר

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

action.devices.commands.ColorLoop

מבקשים מהמכשיר לעבור בין צבעים שונים.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

פרמטרים

דוגמאות

Colorloop my lights for 60 minutes.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

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

{
  "supportedEffects": [
    "sleep"
  ]
}

פרמטרים

דוגמאות

Make my lights sleep for 60 minutes.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

עוצרים את אפקט התאורה הנוכחי.

פרמטרים

דוגמאות

הפסקת האפקט בנורה שלי

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

action.devices.commands.Wake

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

{
  "supportedEffects": [
    "wake"
  ]
}

פרמטרים

דוגמאות

Make my lights wake for 60 minutes

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

אמולציה של אפקטים של אור

אם המכשיר מטמיע את המאפיין Brightness אבל לא את המאפיין LightEffects, הפלטפורמה תומכת באפקטים של 'שינה' ו'התעוררות' שהועתקו, בלי צורך בקוד נוסף. הפלטפורמה מחקה את האפקטים על ידי שליחת סדרה של כוונות EXECUTE.

ביטויים לדוגמה

ERRORS במכשיר