智能家居 HumiditySetting 特征架构
action.devices.traits.HumiditySetting
- 此特征属于支持湿度设置的设备,例如加湿器和除湿器。
设备属性
具有此特征的设备可能会在 SYNC
操作过程中报告以下属性。如需详细了解如何处理 SYNC
intent,请参阅 intent 执行方式。
属性 | 类型 | 说明 |
---|---|---|
humiditySetpointRange |
对象 |
以百分比形式包含最低和最高湿度水平。 |
minPercent |
整数 |
(默认值: 以百分比表示最低湿度。 |
maxPercent |
整数 |
(默认值: 以百分比表示最高湿度。 |
commandOnlyHumiditySetting |
Boolean |
(默认值: 指明设备是否支持使用单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态,请将此属性设为 true。 |
queryOnlyHumiditySetting |
Boolean |
(默认值: 如果设备支持仅执行查询,则为必需。此属性指示设备是否只能查询状态信息,且无法控制。 |
示例
支持默认湿度范围的设备。
{}
支持自定义湿度范围的设备。
{ "humiditySetpointRange": { "minPercent": 25, "maxPercent": 75 } }
设备状态
具有此特征的实体可能会在 QUERY
操作过程中报告以下状态。如需详细了解如何处理 QUERY
intent,请参阅 intent 执行方式。
州 | 类型 | 说明 |
---|---|---|
humiditySetpointPercent |
整数 |
指示设备的当前目标湿度百分比。必须在 |
humidityAmbientPercent |
整数 |
以百分比表示设备的当前环境湿度读数。 |
示例
我的设备显示的湿度是多少?
{ "humiditySetpointPercent": 20, "humidityAmbientPercent": 15 }
设备命令
具有此特征的设备可能会在 EXECUTE
操作过程中响应以下命令。如需详细了解如何处理 EXECUTE
intent,请参阅 intent 执行方式。
action.devices.commands.SetHumidity
将湿度设置为绝对值。
参数
参数 | 类型 | 说明 |
---|---|---|
humidity |
整数 |
必填。 设定点湿度百分比。必须在 |
示例
将湿度设为百分之 20。
{ "command": "action.devices.commands.SetHumidity", "params": { "humidity": 20 } }
相关错误
设置目标湿度时出错。
支持的值:
maxSettingReached
minSettingReached
valueOutOfRange
action.devices.commands.HumidityRelative
根据当前值调整湿度。
此命令需要以下特性:{ "commandOnlyHumiditySetting": true }
参数
载荷包含以下各项之一:
设置湿度百分比。
参数 | 类型 | 说明 |
---|---|---|
humidityRelativePercent |
整数 |
必填。 用于调整湿度水平的百分比值。 |
设置湿度权重。
参数 | 类型 | 说明 |
---|---|---|
humidityRelativeWeight |
整数 |
必填。 表示从少量(“一点”)到较大(“很多”)的不明确湿度变化量。 |
示例
将湿度调高百分之 10
{ "command": "action.devices.commands.HumidityRelative", "params": { "humidityRelativePercent": 10 } }
大幅降低湿度
{ "command": "action.devices.commands.HumidityRelative", "params": { "humidityRelativeWeight": -5 } }
相关错误
调整湿度时出错。
支持的值:
maxSettingReached
minSettingReached
valueOutOfRange
示例话语
de-DE
- Welche Luftfeuchtigkeit zeigt das Thermostat an?
en-US
- what is the humidity upstairs
es-ES
- cuánta humedad hay ahora en la cocina
fr-FR
- le thermostat donne quel taux d'humidité
hi-IN
- ह्यूमिडिटी का स्तर किचन के थर्मोस्टैट से कितना है?
it-IT
- quanta umidità segna il termostato
ja-JP
- サーモスタット にどれくらいの湿度ってでてる
ko-KR
- 온도 조절계 에 습도 몇이야?
nl-NL
- wat is de vochtigheid op de thermostaat
pt-BR
- Qual é o nível de humidade mostrado no termostato ?
- diga qual é a umidade relativa do ar mostrada no termostato
sv-SE
- Vad är det för luftfuktighet i badrummet ?