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

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

设备属性

具有此特征的设备可能会报告以下 属性作为 SYNC 操作的一部分。如需详细了解如何处理 SYNC intent，请参阅 intent 执行。

属性 类型 说明
humiditySetpointRange 对象

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

（默认值：0）

以百分比表示最低湿度水平。

值必须介于 0 到 100 之间。
maxPercent 整数

（默认值：100）

以百分比表示最高湿度水平。

值必须介于 0 到 100 之间。
commandOnlyHumiditySetting 布尔值

（默认值：false）

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

（默认值：false）

如果设备支持仅查询执行，则为必填项。此属性指明设备是否只能查询状态信息，而无法控制。

示例

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

{}

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

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

设备状态

具有此特征的实体可能会报告以下 状态作为 QUERY 操作的一部分。如需详细了解如何处理 QUERY intent，请参阅 intent 执行。

状态 类型 说明
humiditySetpointPercent 整数

指明设备当前的目标湿度百分比。必须在 humiditySetpointRange 范围内。
humidityAmbientPercent 整数

指明设备当前的周围湿度读数（以百分比表示）。

值必须介于 1 到 100 之间。

示例

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

{
  "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 整数

必填。

用于调整湿度水平的百分比值。

值必须介于 -100 到 100 之间。

设置湿度权重。

参数 类型 说明
humidityRelativeWeight 整数

必填。

指明模糊湿度变化量，从少量（“一点”）到大量（“很多”）。

值必须介于 -5 到 5 之间。

示例

将湿度调高 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 ?

设备错误

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