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

話語範例

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

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