スマートホームの 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 ?

デバイスエラー

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