智慧型住宅 LightEffects 特徵結構定義
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