智慧型住宅照明效果偏差架構
action.devices.traits.LightEffects
- 這個小點所屬的裝置可以支援複雜的照明指令來變更狀態,例如在各種顏色的循環播放。
裝置屬性
具有此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求一文。
屬性 | 類型 | 說明 |
---|---|---|
defaultColorLoopDuration |
整數 |
(預設: 由 |
defaultSleepDuration |
整數 |
(預設: 由 |
defaultWakeDuration |
整數 |
(預設: 由 |
supportedEffects |
陣列 |
必填。 裝置支援的效果清單。 |
[item, ...] |
字串 |
支援的效果。 支援的值:
|
範例
支援色彩循環效果的裝置。
{ "supportedEffects": [ "colorLoop" ] }
支援睡眠/喚醒效果的裝置。
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
activeLightEffect |
字串 |
目前使用中的燈光效果 (如果有的話)。 支援的值:
|
lightEffectEndUnixTimestampSec |
整數 |
效果預期結束時結束的 Unix 時間戳記 (如果效果本身結束)。 |
範例
我的裝置目前有何影響?
{ "activeLightEffect": "colorLoop" }
我的裝置目前有何影響?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
目前未使用燈光效果。
{}
裝置指令
具有此特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱意圖執行要求一文。
action.devices.commands.ColorLoop
要求裝置循環顯示一組顏色。
這個指令需要下列屬性:{ "supportedEffects": [ "colorLoop" ] }
參數
參數 | 類型 | 說明 |
---|---|---|
duration |
整數 |
色彩循環指令的持續時間,以秒為單位。 |
範例
將燈光調暗 60 分鐘。
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
逐漸降低裝置的亮度,並視需要調整一段時間內的色溫。
這個指令需要下列屬性:{ "supportedEffects": [ "sleep" ] }
參數
參數 | 類型 | 說明 |
---|---|---|
duration |
整數 |
睡眠指令的時間長度,以秒為單位。 |
範例
將燈具休眠 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 |
整數 |
喚醒指令的時間,以秒為單位。 |
範例
將燈具喚醒 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 noquarto dos miudos . -
Iniciar o modo dormir
por 1 hora nasluzes do quarto . -
Liga a função adormecer das
luzes .
sv-SE
-
Starta insomningsläge på
lamporna -
Tänd
lamporna långsamt