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

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 ?

设备出错

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