欢迎使用 Google Home 开发者中心,您可以在这里学习有关如何开发智能家居 Action 的新平台。注意:你将继续在 Actions 控制台中构建操作。
使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

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

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 ?

设备出错

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