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

action.devices.traits.HumiditySetting - 凡是支援濕度設定的裝置，都具備這項特徵，例如加濕器和除濕機。

裝置屬性

具有這項特徵的裝置可能會回報下列屬性，做為 SYNC 作業的一部分。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖完成」。

屬性 類型 說明
humiditySetpointRange 物件

包含以百分比表示的最低和最高濕度。
minPercent 整數

(預設值：0)

以百分比表示最低濕度。

值必須介於 0 至 100 之間
maxPercent 整數

(預設值：100)

代表最高濕度百分比。

值必須介於 0 至 100 之間
commandOnlyHumiditySetting 布林值

(預設值：false)

指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應這項特徵的 QUERY 意圖或回報狀態，請將這個屬性設為 true。
queryOnlyHumiditySetting 布林值

(預設值：false)

如果裝置支援僅查詢執行作業，則為必要屬性。這項屬性會指出裝置是否只能查詢狀態資訊，而無法控制。

範例

支援預設濕度範圍的裝置。

{}

支援自訂濕度範圍的裝置。

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

裝置狀態

具有這項特徵的實體可能會回報下列狀態，做為 QUERY 作業的一部分。如要進一步瞭解如何處理 QUERY 意圖，請參閱「意圖完成」。

州 類型 說明
humiditySetpointPercent 整數

指出裝置目前的目標濕度百分比。必須在 humiditySetpointRange 內。
humidityAmbientPercent 整數

指出裝置目前測得的環境濕度，以百分比表示。

值必須介於 1 至 100 之間

範例

裝置顯示的濕度為何？

{
  "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 整數

必要。

用來調整濕度的百分比值。

值必須介於 -100 至 100 之間

設定濕度權重。

參數 類型 說明
humidityRelativeWeight 整數

必要。

表示濕度變化量，從少量 (「一點點」) 到大量 (「很多」)。

值必須介於 -5 至 5 之間

範例

將濕度調高 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 ?

裝置錯誤

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