スマートホームの HumiditySetting トレイト スキーマ

action.devices.traits.HumiditySetting - このトレイトは、加湿器や除湿器など、湿度設定が可能なデバイスに使用します。

デバイスの属性

このトレイトを持つデバイスは、SYNC オペレーションの一部として次の属性を報告できます。SYNC インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

属性 タイプ 説明
humiditySetpointRange オブジェクト

最小湿度レベルと最大湿度レベルをパーセンテージで格納します。
minPercent 整数

（デフォルト: 0）

最小湿度レベルをパーセンテージで表します。
maxPercent 整数

（デフォルト: 100）

最大湿度レベルをパーセンテージで表します。
commandOnlyHumiditySetting ブール値

（デフォルト: false）

デバイスが一方向（true）または双方向（false）の通信の使用をサポートしているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を 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 ?

デバイスエラー

エラーと例外の全リストをご覧ください。