Smart Home HumiditySetting Trait Schema

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

设备属性

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

属性 类型 说明
humiditySetpointRange 对象

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

（默认值：0）

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

（默认值：100）

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

（默认值：false）

指示设备是否支持使用单向（true）或双向（false）通信。如果设备无法响应此特征的 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 ?

设备错误

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