智慧型住宅 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

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