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

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

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

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

מאפיינים סוג תיאור
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"
  ]
}

מכשיר STATES

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

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

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

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

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Integer

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

דוגמאות

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

{
  "activeLightEffect": "colorLoop"
}

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

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

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

{}

COMMANDS של מכשיר

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

action.devices.commands.ColorLoop

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

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

פרמטרים

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

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

דוגמאות

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

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

action.devices.commands.Sleep

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

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

פרמטרים

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

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

דוגמאות

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

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

דוגמאות

מגדירים שהאורות יתעוררו למשך 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

כדאי לעיין ברשימה המלאה של שגיאות וחריגים.