歡迎來到 Google Home 開發人員中心,你可以在這裡學習如何學習智慧型住宅動作。注意事項:您將在 Actions 主控台建構動作。

智慧型住宅 HumiditySetting Trait 結構定義

action.devices.traits.HumiditySetting - 這個特性代表裝置支援濕度設定,例如加濕器和除濕機。

裝置屬性

具此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖,請參閱意圖執行要求

屬性 類型 說明
humiditySetpointRange 物件

包含最小和最大濕度百分比。

minPercent 整數

(預設值:0)

代表最低濕度下限。

maxPercent 整數

(預設值:100)

代表最大濕度百分比。

commandOnlyHumiditySetting 布林

(預設值:false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法針對此特性回應 QUERY 意圖或報告狀態,請將這項屬性設為 true。

queryOnlyHumiditySetting 布林

(預設值:false)

如果裝置支援「僅限查詢」執行作業,則為必要欄位。這項屬性可指出裝置只能查詢狀態資訊,且無法控制。

範例

支援預設濕度的裝置。

{}

支援自訂濕度的裝置。

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

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求

類型 說明
humiditySetpointPercent 整數

表示裝置目前的目標濕度百分比。必須位於 humiditySetpointRange 之內。

humidityAmbientPercent 整數

以目前百分比顯示裝置目前的環境濕度讀數。

範例

我的裝置顯示了多少濕度?

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

裝置指令

具有此特性的裝置可能會回應 EXECUTE 作業中的下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱意圖執行要求

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 ?

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。