欢迎使用 Google Home 开发者中心,这是一个学习如何开发智能家居 Action 的新平台。注意:构建 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 ?

设备错误

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