Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

デバイスエラー

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