智慧型住宅 HumiditySetting 特徵結構定義

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 ?

裝置錯誤

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