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

サンプル音声

<ph type="x-smartling-placeholder">

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 ?

デバイスエラー

詳しくは、 エラーと例外をご覧ください。