智能家居 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 ?

设备出错

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