スマートホームの HumiditySetting トレイト スキーマ
action.devices.traits.HumiditySetting
- このトレイトは、加湿器、除湿機などの湿度設定をサポートするデバイスに使用します。
デバイスの属性
このトレイトを持つデバイスは、SYNC
オペレーションの一部として次の属性を報告できます。SYNC
インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
humiditySetpointRange |
温度計 |
最小湿度レベルと最大湿度レベルがパーセンテージで含まれます。 |
minPercent |
Integer |
(デフォルト: 最小湿度レベルをパーセンテージで表したものです。 |
maxPercent |
Integer |
(デフォルト: 最大湿度レベルをパーセンテージで表したものです。 |
commandOnlyHumiditySetting |
ブール値 |
(デフォルト: デバイスが一方向(True)または双方向(False)の通信に対応しているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。 |
queryOnlyHumiditySetting |
ブール値 |
(デフォルト: デバイスが問い合わせのみの実行をサポートしている場合、必須。この属性は、状態情報の取得のみが可能で、制御はできないデバイスを示します。 |
例
デフォルトの湿度範囲をサポートしているデバイス。
{}
カスタム湿度範囲をサポートするデバイス。
{ "humiditySetpointRange": { "minPercent": 25, "maxPercent": 75 } }
デバイスのステータス
このトレイトを使用するエンティティは、QUERY
オペレーションの一部として次の状態を報告できます。QUERY
インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
状態 | タイプ | 説明 |
---|---|---|
humiditySetpointPercent |
Integer |
デバイスの現在の目標湿度パーセンテージを示します。 |
humidityAmbientPercent |
Integer |
デバイスの現在の周囲湿度測定値をパーセンテージで示します。 |
例
デバイスの湿度はどのくらいですか?
{ "humiditySetpointPercent": 20, "humidityAmbientPercent": 15 }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一環として次のコマンドに応答できます。EXECUTE
インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。
action.devices.commands.SetHumidity
湿度レベルを絶対値に設定します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
humidity |
Integer |
必須。 設定湿度の割合。 |
例
湿度を 20% に設定します。
{ "command": "action.devices.commands.SetHumidity", "params": { "humidity": 20 } }
関連エラー
目標湿度の設定中にエラーが発生しました。
サポートされる値:
maxSettingReached
minSettingReached
valueOutOfRange
action.devices.commands.HumidityRelative
湿度を現在の値に基づいて調整します。
このコマンドには次の属性が必要です。{ "commandOnlyHumiditySetting": true }
パラメータ
ペイロードには次のいずれかが含まれています。
湿度パーセンテージを設定します。
パラメータ | タイプ | 説明 |
---|---|---|
humidityRelativePercent |
Integer |
必須。 湿度レベルを調整する割合(%)です。 |
湿度ウェイトを設定します。
パラメータ | タイプ | 説明 |
---|---|---|
humidityRelativeWeight |
Integer |
必須。 湿度が「ごく少量」から「大量」(大量)に変化した割合を示します。 |
例
湿度を 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 ?