智能家居 HumiditySetting 特征架构

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 ?

设备出错

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