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

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"
  ]
}

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה 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

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

דוגמאות

Colorloop my lights for 60 minutes.

{
  "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, הפלטפורמה תומכת באמולציה של 'שינה' ו-"wake" בלי צורך בתכנות נוסף. הפלטפורמה מבצעת אמולציה של האפקטים על ידי שליחת סדרה של כוונות 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 במכשיר

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