智慧型住宅濕度設定特徵結構定義

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 ?

裝置錯誤

查看完整清單 錯誤和例外狀況。