Smart Home HumiditySetting Trait Schema

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

设备属性

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

属性 类型 说明
humiditySetpointRange 对象

包含最低和最高湿度水平（以百分比表示）。
minPercent 整数

（默认值：0）

以百分比表示最低湿度级别。
maxPercent 整数

（默认值：100）

以百分比表示的最大湿度级别。
commandOnlyHumiditySetting 布尔值

（默认值：false）

指示设备是否支持使用单向（true）或双向（false）通信。如果设备无法响应此 trait 的 QUERY intent 或报告状态，请将此属性设为 true。
queryOnlyHumiditySetting 布尔值

（默认值：false）

如果设备支持仅查询执行，则必需。此属性表示是否只能查询设备的状态信息，而无法控制设备。

示例

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

{}

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

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

设备状态

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

州 类型 说明
humiditySetpointPercent 整数

表示设备的当前目标湿度百分比。必须在 humiditySetpointRange 内。
humidityAmbientPercent 整数

以百分比表示设备的当前环境湿度读数。

示例

我的设备显示的湿度是多少？

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

设备命令

具有此 trait 的设备可能会在 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 ?

设备错误

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