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

裝置錯誤

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