智能家居湿度设置特征架构

action.devices.traits.HumiditySetting - 此特征属于支持湿度设置的设备，例如加湿器和除湿器。

设备属性

具有此特征的设备可以在 SYNC 操作中报告以下属性。如需详细了解如何处理 SYNC intent，请参阅 intent 执行方式。

属性	类型	说明
humiditySetpointRange	对象	包含最小和最大湿度水平（以百分比表示）。
minPercent	整数	（默认：0） 以百分比表示最低湿度水平。
maxPercent	整数	（默认：100） 以百分比表示最大湿度水平。
commandOnlyHumiditySetting	Boolean	（默认：false） 指示设备是否支持单向 (true) 或双向 (false) 通信。如果设备无法响应此特征的 QUERY intent 或报告状态，请将此属性设为 true。
queryOnlyHumiditySetting	Boolean	（默认：false） 如果设备支持仅执行查询，则必须提供。此属性指示设备是否只能查询状态信息，且无法控制。

示例

支持默认湿度范围的设备。

{}

支持自定义湿度范围的设备。

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

设备状态

具有此特征的实体可以在 QUERY 操作中报告以下状态。如需详细了解如何处理 QUERY intent，请参阅 intent 执行方式。

州	类型	说明
humiditySetpointPercent	整数	指示设备的当前目标湿度百分比。必须在 humiditySetpointRange 之内。
humidityAmbientPercent	整数	以百分比表示设备的当前环境湿度读数。

示例

我的设备显示什么样的湿度？

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

设备命令

具有此特征的设备可能会在 EXECUTE 操作中响应以下命令。如需详细了解如何处理 EXECUTE intent，请参阅 intent 执行方式。

action.devices.commands.SetHumidity

将湿度级别设置为绝对值。

参数

参数	类型	说明
humidity	整数	必填。 设定点的湿度百分比。必须在 humiditySetpointRange 之内。

示例

将湿度设置为 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 ?

设备错误

查看错误和异常的完整列表。