智慧型住宅 HumiditySetting Trait 結構定義
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 ?