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

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

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

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

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

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

משך ברירת המחדל, בשניות, של האפקט שמופעל על ידי הפקודה action.devices.commands.ColorLoop.

defaultSleepDuration Integer

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

משך ברירת המחדל, בשניות, של האפקט שמופעל על ידי הפקודה action.devices.commands.Sleep.

defaultWakeDuration Integer

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

משך ברירת המחדל, בשניות, של האפקט שמופעל על ידי הפקודה action.devices.commands.Wake.

supportedEffects מערך

חובה.

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

[item, ...] String

אפקט נתמך.

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

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

דוגמאות

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

{
  "supportedEffects": [
    "colorLoop"
  ]
}

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

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

מצבי מכשיר

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

מדינות סוג תיאור
activeLightEffect String

אפקט התאורה שפעיל כרגע, אם יש כזה. אחת מהאפשרויות: supportedEffects.

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

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Integer

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

דוגמאות

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

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

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

action.devices.commands.ColorLoop

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

הפקודה הזו דורשת את המאפיינים הבאים:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

פרמטרים

פרמטרים סוג תיאור
duration Integer

משך הזמן של הפקודה לשינוי צבעים, בשניות.

דוגמאות

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

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

action.devices.commands.Sleep

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

הפקודה הזו דורשת את המאפיינים הבאים:
{
  "supportedEffects": [
    "sleep"
  ]
}

פרמטרים

פרמטרים סוג תיאור
duration Integer

משך הזמן של פקודת השינה, בשניות, בטווח של 300 עד 3,600.

דוגמאות

תעביר את האורות למצב שינה למשך 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"
  ]
}

פרמטרים

פרמטרים סוג תיאור
duration Integer

משך הזמן של פקודת ההפעלה, בשניות, בטווח של 300 עד 3,600.

דוגמאות

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

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

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

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

דוגמאות לביטויים

de-DE

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

fr-FR

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

hi-IN

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

it-IT

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライト を徐々に明るくなる設定にして
  • 照明 を少しずつ暗くして

ko-KR

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

pt-BR

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

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

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