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

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

デバイスの属性

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

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

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

（デフォルト: 0）

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

値は 0～100 の範囲で指定してください
maxPercent 整数

（デフォルト: 100）

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

値は 0～100 の範囲で指定してください
commandOnlyHumiditySetting ブール値

（デフォルト: false）

デバイスが一方向（true）または双方向（false）のいずれの通信を使用して動作しているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたはステータスの通知に応答できない場合は、この属性を true に設定します。
queryOnlyHumiditySetting ブール値

（デフォルト: false）

デバイスが問い合わせのみの実行をサポートしている場合、必須。デバイスが、ステータス情報の問い合わせができるだけで、制御はできないかどうかを示します。

例

デフォルトの湿度範囲をサポートするデバイス 

{}

カスタムの湿度範囲をサポートするデバイス 

{
  "humiditySetpointRange": {
    "minPercent": 25,
    "maxPercent": 75
  }
}

デバイスのステータス

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

州 タイプ 説明
humiditySetpointPercent 整数

デバイスの現在の目標湿度パーセンテージを示します。humiditySetpointRange の範囲内に収める必要があります。
humidityAmbientPercent 整数

デバイスの現在の周囲湿度測定値をパーセンテージで示します。

値は 1～100 の範囲で指定してください

例

デバイスに表示されている湿度は？ 

{
  "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 整数

必須。

湿度レベルを調整するためのパーセンテージ値。

値は -100～100 の範囲で指定してください

湿度ウェイトを設定します。

パラメータ タイプ 説明
humidityRelativeWeight 整数

必須。

小幅な変更（「少し」）から大幅な変更（「大幅に」）までのあいまいな湿度変更の量を示します。

値は -5～5 の範囲で指定してください

例

湿度を 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 ?

デバイスエラー

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