歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

Smart Home 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
  }
}

裝置狀態:STATE

具有此特性的裝置可能會在 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

裝置錯誤:ERRORS

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