智能家居 LightEffects 特征架构
action.devices.traits.LightEffects - 此 trait 属于可以支持复杂光照命令来更改状态（例如循环播放各种颜色）的设备。
设备属性
具有此特征的设备可能会报告以下内容
作为 SYNC 操作的一部分。学习内容
有关处理 SYNC intent 的更多信息，请参阅
intent 执行方式。
| 属性 | 类型 | 说明 |
|---|---|---|
defaultColorLoopDuration |
整数 |
（默认值： 由 |
defaultSleepDuration |
整数 |
（默认值： 由 |
defaultWakeDuration |
整数 |
（默认值： 由 |
supportedEffects |
数组 |
必填。 设备支持的效果列表。 |
[item, ...] |
String |
支持的效果。 支持的值：
|
示例
支持颜色循环效果的设备。
{
"supportedEffects": [
"colorLoop"
]
}
支持睡眠/唤醒效果的设备。
{
"defaultSleepDuration": 300,
"defaultWakeDuration": 600,
"supportedEffects": [
"sleep",
"wake"
]
}
设备状态
具有此特征的实体可能会报告以下内容
QUERY 操作包含的指定状态。学习内容
有关处理 QUERY intent 的更多信息，请参阅
intent 执行方式。
| 州 | 类型 | 说明 |
|---|---|---|
activeLightEffect |
String |
当前有效的光效（如果有）。 支持的值：
|
lightEffectEndUnixTimestampSec |
整数 |
预计效果结束的 Unix 时间戳（如果效果自行结束）。 |
示例
我的设备目前会受到什么影响？
{
"activeLightEffect": "colorLoop"
}
我的设备目前会受到什么影响？
{
"activeLightEffect": "sleep",
"lightEffectEndUnixTimestampSec": 1595286869
}
目前未开启任何灯光效果。
{}
设备命令
具有此特征的设备可能会响应以下内容
作为 EXECUTE 操作的一部分。学习内容
有关处理 EXECUTE intent 的更多信息，请参阅
intent 执行方式。
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 特征，
平台支持模拟的“sleep”和“唤醒”效果，而无需额外编写代码。
平台通过发送一系列 EXECUTE intent 来模拟效果。
示例话语
<ph type="x-smartling-placeholder">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