智慧型住宅 HumiditySetting 特徵
action.devices.traits.HumiditySetting
- 這個特性屬於支援濕度設定的裝置,例如加濕器和除濕機。
裝置屬性
具備這個特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱「意圖執行要求」。
屬性 | 類型 | 說明 |
---|---|---|
humiditySetpointRange |
物件 |
最低及最高溼度以百分比表示。 |
minPercent |
整數 |
(預設值: 以百分比表示最低濕度。 |
maxPercent |
整數 |
(預設值: 以百分比表示最高濕度。 |
commandOnlyHumiditySetting |
布林 |
(預設值: 指出裝置是否支援單向 (true) 或雙向 (false) 通訊。如果裝置無法回應此特性的 QUERY 意圖或報告狀態,請將此屬性設為 true。 |
queryOnlyHumiditySetting |
布林 |
(預設值: 如果裝置支援僅限查詢執行,則為必要欄位。這項屬性可指出裝置是否只能查詢狀態資訊,且無法控制。 |
範例
支援預設濕度範圍的裝置。
{}
支援自訂濕度範圍的裝置。
{ "humiditySetpointRange": { "minPercent": 25, "maxPercent": 75 } }
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱「意圖執行要求」。
狀態 | 類型 | 說明 |
---|---|---|
humiditySetpointPercent |
整數 |
表示裝置目前的目標濕度百分比。必須遵守在 |
humidityAmbientPercent |
整數 |
以百分比表示裝置目前的環境濕度讀數。 |
範例
我的裝置會顯示什麼濕度?
{ "humiditySetpointPercent": 20, "humidityAmbientPercent": 15 }
裝置指令
具有這個特性的裝置可能會在 EXECUTE
作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE
意圖,請參閱「意圖執行要求」。
action.devices.commands.SetHumidity
將濕度設為絕對值。
參數
參數 | 類型 | 說明 |
---|---|---|
humidity |
整數 |
必要。 設定點濕度百分比。必須遵守在 |
範例
將濕度設為 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 ?