Smart Home LightEffects Trait Schema

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

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

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

דוגמאות

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

מצבי המכשיר

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

דוגמאות

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

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

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

action.devices.commands.ColorLoop

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

פרמטרים

דוגמאות

תפעיל את האפקט Colorloop באורות שלי למשך 60 דקות.

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

action.devices.commands.Sleep

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

{
  "supportedEffects": [
    "sleep"
  ]
}

פרמטרים

דוגמאות

תעביר את התאורה למצב שינה למשך 60 דקות.

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

action.devices.commands.StopEffect

הפסקת אפקט התאורה הנוכחי.

פרמטרים

דוגמאות

הפסקת האפקט בנורה

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

action.devices.commands.Wake

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

{
  "supportedEffects": [
    "wake"
  ]
}

פרמטרים

דוגמאות

תדליק את האורות למשך 60 דקות.

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

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

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

דוגמאות לניסוחים

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