智慧型住宅照明效果結構定義
action.devices.traits.LightEffects
- 這種特徵屬於可支援複雜光源指令來變更狀態的裝置,例如循環切換多種顏色。
裝置屬性
具備這項特徵的裝置可能會回報下列資料:
在 SYNC
作業中使用屬性變更。學習
如要進一步瞭解如何處理 SYNC
意圖,請參閱
意圖執行要求。
屬性 | 類型 | 說明 |
---|---|---|
defaultColorLoopDuration |
整數 |
(預設值: 由 |
defaultSleepDuration |
整數 |
(預設值: 由 |
defaultWakeDuration |
整數 |
(預設值: 由 |
supportedEffects |
陣列 |
必要。 裝置支援的效果清單。 |
[item, ...] |
String |
支援的效果。 支援的值:
|
範例
裝置支援色彩循環效果。
{ "supportedEffects": [ "colorLoop" ] }
支援睡眠/喚醒效果的裝置。
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
裝置狀態
具有此特徵的實體可能會回報下列資料:
做為 QUERY
作業的一部分。學習
如要進一步瞭解如何處理 QUERY
意圖,請參閱
意圖執行要求。
州 | 類型 | 說明 |
---|---|---|
activeLightEffect |
String |
目前使用中的光源 (如有)。請選擇 支援的值:
|
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 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