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

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

ATTRIBUTES במכשיר

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

מאפיינים	Type	תיאור
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 כוונות זמין בקטע מימוש כוונה.

מדינות	Type	תיאור
activeLightEffect	String	כרגע יש אפקט אור פעיל. אחד מאלה: supportedEffects. ערכים נתמכים: colorLoop sleep wake
lightEffectEndUnixTimestampSec	Integer	חותמת זמן של Unix כאשר האפקט צפוי להסתיים, אם האפקט מסתיים מעצמו.

דוגמאות

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

פקודות מכשיר

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

action.devices.commands.ColorLoop

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

פקודה זו מחייבת את המאפיינים הבאים:

{
  "supportedEffects": [
    "colorLoop"
  ]
}

פרמטרים

פרמטרים	Type	תיאור
duration	Integer	משך הזמן של פקודת הלולאה הצבעונית, בשניות.

דוגמאות

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

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

action.devices.commands.Sleep

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

פקודה זו מחייבת את המאפיינים הבאים:

{
  "supportedEffects": [
    "sleep"
  ]
}

פרמטרים

פרמטרים	Type	תיאור
duration	Integer	משך הזמן של פקודת השינה, בשניות.

דוגמאות

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

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

action.devices.commands.StopEffect

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

פרמטרים

פרמטרים	Type	תיאור
אין נכסים

דוגמאות

עצירת האפקט של התאורה שלי.

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

action.devices.commands.Wake

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

פקודה זו מחייבת את המאפיינים הבאים:

{
  "supportedEffects": [
    "wake"
  ]
}

פרמטרים

פרמטרים	Type	תיאור
duration	Integer	משך הזמן של פקודת ההשכמה, בשניות.

דוגמאות

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

ERRORS מכשיר

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