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

action.devices.traits.HumiditySetting - このトレイトは、加湿器、除湿機などの湿度設定をサポートするデバイスに使用します。

デバイスの属性

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

属性 タイプ 説明
humiditySetpointRange 温度計

最小湿度レベルと最大湿度レベルがパーセンテージで含まれます。
minPercent Integer

（デフォルト: 0）

最小湿度レベルをパーセンテージで表したものです。
maxPercent Integer

（デフォルト: 100）

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

（デフォルト: false）

デバイスが一方向（True）または双方向（False）の通信に対応しているかどうかを示します。デバイスがこのトレイトの QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。
queryOnlyHumiditySetting ブール値

（デフォルト: false）

デバイスが問い合わせのみの実行をサポートしている場合、必須。この属性は、状態情報の取得のみが可能で、制御はできないデバイスを示します。

例

デフォルトの湿度範囲をサポートしているデバイス。

{}

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

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

デバイスのステータス

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

状態 タイプ 説明
humiditySetpointPercent Integer

デバイスの現在の目標湿度パーセンテージを示します。humiditySetpointRange 内である必要があります。
humidityAmbientPercent Integer

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

例

デバイスの湿度はどのくらいですか？

{
  "humiditySetpointPercent": 20,
  "humidityAmbientPercent": 15
}

デバイスのコマンド

このトレイトを持つデバイスは、EXECUTE オペレーションの一環として次のコマンドに応答できます。EXECUTE インテントの処理の詳細については、インテントのフルフィルメントをご覧ください。

action.devices.commands.SetHumidity

湿度レベルを絶対値に設定します。

パラメータ

パラメータ タイプ 説明
humidity Integer

必須。

設定湿度の割合。humiditySetpointRange 内である必要があります。

例

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

デバイスエラー

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