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

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

action.devices.traits.TemperatureSetting - このトレイトは、温度ポイントとモードの両方を処理します。

デバイスの属性

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

属性 タイプ 説明
availableThermostatModes

必須。

このデバイスがサポートするサーモスタット モードについて説明します。

次のいずれかをサポートします。
0 文字列

サポート終了

このデバイスでサポートされているモードのカンマ区切りリスト。新しい統合では、この属性の Array 形式を使用する必要があります。

1 配列

このデバイスでサポートされているモードのリスト。

[item, ...] 文字列

サポートされているモードの名前。

サポートされている値:

off
暖房 / 冷房アクティビティが無効
heat
デバイスが暖房に対応
cool
デバイスが冷却機能に対応していること
on
デバイスの以前のモードを復元します。on モードは設計上デバイスの以前のモードを復元するために使用されるため、モード選択画面に on モードは表示されません。
heatcool
暖房 / 冷房の目標範囲を維持
auto
温度がスケジュールまたは学習した動作によって設定される自動モード
fan-only
暖房/冷房機能がないファン
purifier
浄化モード
eco
省エネモード
dry
ドライモード
thermostatTemperatureRange オブジェクト

このデバイスでサポートされている温度範囲を示す 2 つの浮動小数点数値(摂氏)が含まれます。

minThresholdCelsius Number

必須。

温度範囲の最小しきい値。

maxThresholdCelsius Number

必須。

温度範囲の最大しきい値。

thermostatTemperatureUnit 文字列

必須。

デバイスがデフォルトで設定されているディスプレイ ユニット。Google は、ディスプレイ ユニットを使用して気温情報を報告します。

サポートされている値:

C
F
bufferRangeCelsius Number

(デフォルト: 2

heatcool モードがサポートされている場合、暖房と冷房の設定間の最小オフセットを摂氏で示します。

commandOnlyTemperatureSetting ブール値

(デフォルト: false

デバイスが一方向(true)または双方向(false)の通信をサポートしているかどうかを示します。デバイスがこのトレイトに対応する QUERY インテントまたは Report State に応答できない場合は、この属性を true に設定します。

queryOnlyTemperatureSetting ブール値

(デフォルト: false

デバイスが問い合わせのみの実行をサポートしている場合、必須。この属性は、デバイスの状態に関するクエリのみが可能で、制御はできないかどうかを示します。

個別の暖房換気空調をサポートするサーモスタット

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "F"
}

コマンドのみのサーモスタット デバイス

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "C",
  "commandOnlyTemperatureSetting": true,
  "queryOnlyTemperatureSetting": false
}

デバイスのステータス

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

状態 タイプ 説明
activeThermostatMode 文字列

デバイスのアクティブなモード(availableThermostatModes のリストから取得)。現在アクティブなモードがない場合は、none に設定します。

サポートされている値:

none
アクティブ モードなし
off
暖房 / 冷房アクティビティが無効
heat
デバイスが暖房に対応
cool
デバイスが冷却機能に対応していること
on
デバイスの以前のモードを復元します。on モードは設計上デバイスの以前のモードを復元するために使用されるため、モード選択画面に on モードは表示されません。
heatcool
暖房/冷房の目標範囲を維持
auto
温度がスケジュールまたは学習した動作によって設定される自動モード
fan-only
暖房/冷房機能がないファン
purifier
浄化モード
eco
省エネモード
dry
ドライモード
targetTempReachedEstimateUnixTimestampSec Integer

設定温度に到達する推定時間を表すタイムスタンプ。

thermostatHumidityAmbient Number

デバイスによってサポートされている場合、周囲の湿度の相対レベルを表します。

次のいずれかの項目が含まれます。
0 オブジェクト

固定設定値の状態。

thermostatMode 文字列

必須。

デバイスの現在のモード(availableThermostatModes のリスト)。

サポートされている値:

none
アクティブ モードなし
off
暖房/冷房アクティビティが無効
heat
デバイスが暖房に対応
cool
デバイスが冷却機能に対応していること
on
デバイスの以前のモードを復元する
heatcool
暖房/冷房の目標範囲を維持
auto
温度がスケジュールまたは学習した動作によって設定される自動モード
fan-only
暖房 / 冷房機能がないファン
purifier
浄化モード
eco
省エネモード
dry
ドライモード
thermostatTemperatureAmbient Number

必須。

現在の観測温度(摂氏)。

thermostatTemperatureSetpoint Number

必須。

現在の温度設定温度(単一の目標、摂氏)。

1 オブジェクト

設定値の状態。

thermostatMode 文字列

必須。

デバイスの現在のモード(availableThermostatModes のリスト)。

サポートされている値:

none
アクティブ モードなし
off
暖房 / 冷房アクティビティが無効
heat
デバイスが暖房に対応
cool
デバイスが冷却機能に対応していること
on
デバイスの以前のモードを復元する
heatcool
暖房/冷房の目標範囲を維持
auto
温度がスケジュールまたは学習した動作によって設定される自動モード
fan-only
暖房/冷房機能がないファン
purifier
浄化モード
eco
省エネモード
dry
ドライモード
thermostatTemperatureAmbient Number

必須。

現在の観測温度(摂氏)。

thermostatTemperatureSetpointHigh Number

必須。

現在の最高点(heatcool モードの場合)。

thermostatTemperatureSetpointLow Number

必須。

現在の範囲は、heatcool モードの場合は範囲です。

デバイスの現在の温度はどのくらいですか?

{
  "activeThermostatMode": "cool",
  "thermostatMode": "cool",
  "thermostatTemperatureSetpoint": 23,
  "thermostatTemperatureAmbient": 25.1
}

デバイスの現在の温度はどのくらいですか?

{
  "activeThermostatMode": "none",
  "thermostatMode": "heatcool",
  "thermostatTemperatureSetpointHigh": 26,
  "thermostatTemperatureSetpointLow": 22,
  "thermostatTemperatureAmbient": 25.1
}

デバイスのコマンド

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

action.devices.commands.ThermostatTemperatureSetpoint

サーモスタット デバイスの設定温度を設定します。

パラメータ

パラメータ タイプ 説明
thermostatTemperatureSetpoint Number

必須。

設定温度。小数点以下は 1 桁までサポートします。

デバイスの温度を 22 度に設定して。

{
  "command": "action.devices.commands.ThermostatTemperatureSetpoint",
  "params": {
    "thermostatTemperatureSetpoint": 22
  }
}

設定温度の設定中にエラーが発生しました。

サポートされている値:

alreadyAtMax
alreadyAtMin
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatTemperatureSetRange

サーモスタット デバイスの設定温度範囲を設定します。

このコマンドには、次の属性が必要です。
{
  "availableThermostatModes": [
    "heatcool"
  ]
}

パラメータ

パラメータ タイプ 説明
thermostatTemperatureSetpointHigh Number

必須。

範囲に対して高い目標設定値。heatcool モードのサポートが必要です。

thermostatTemperatureSetpointLow Number

必須。

範囲の目標値を低く設定しました。heatcool モードのサポートが必要です。

温度を 22 度から 26 度に設定します。

{
  "command": "action.devices.commands.ThermostatTemperatureSetRange",
  "params": {
    "thermostatTemperatureSetpointHigh": 26,
    "thermostatTemperatureSetpointLow": 22
  }
}

目標範囲の設定中にエラーが発生しました。

サポートされている値:

alreadyAtMax
alreadyAtMin
lockedToRange
rangeTooClose
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatSetMode

サーモスタット デバイスのターゲット動作モードを設定します。

パラメータ

パラメータ タイプ 説明
thermostatMode 文字列

必須。

ターゲット モード(availableThermostatModes のリスト)。

サポートされている値:

off
暖房 / 冷房アクティビティが無効
heat
デバイスが暖房に対応
cool
デバイスが冷却機能に対応していること
on
デバイスの以前のモードを復元する
heatcool
暖房/冷房の目標範囲を維持
auto
温度がスケジュールまたは学習した動作によって設定される自動モード
fan-only
暖房 / 冷房機能がないファン
purifier
浄化モード
eco
省エネモード
dry
ドライモード

デバイスを暖房・冷房モードに設定します。

{
  "command": "action.devices.commands.ThermostatSetMode",
  "params": {
    "thermostatMode": "heatcool"
  }
}

ターゲット モードの設定中にエラーが発生しました。

サポートされている値:

inAutoMode
inAwayMode
inDryMode
inEcoMode
inFanOnlyMode
inHeatOrCool
inHumidifierMode
inOffMode
inPurifierMode

action.devices.commands.TemperatureRelative

現在の温度を基準として設定温度を調整します。

このコマンドには、次の属性が必要です。
{
  "commandOnlyTemperatureSetting": true
}

パラメータ

ペイロードには次のいずれかが含まれます。

度単位で調整できます。

パラメータ タイプ 説明
thermostatTemperatureRelativeDegree Number

必須。

気温の変化の正確な度数(「5 度下げて」など)。

重量で調整します。

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

必須。

これは、多少のあいまいな温度の変化量(「少なめにして」など)を大量変化(「やや暖かい」)で示しています。

温度を 5 度上げて

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeDegree": 5
  }
}

温度を大幅に下げる

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeWeight": -5
  }
}

温度の調整中にエラーが発生しました。

サポートされている値:

alreadyAtMax
alreadyAtMin
valueOutOfRange

サンプル音声

de-DE

  • Heizmodus anmachen
  • マッハ den Heizmodus aus
  • Schalt den Heizmodus vom Thermostat aus
  • Temperatur auf 20 bis 25 Grad einstellen。
  • Thermostat auf 20 bis 25 Grad stellen.
  • Thermostat im Schlafzimmer kälter stellen
  • Wohnzimmer auf Kühlen umstellen
  • bitte dreh das Thermostat ein bisschen Herunter
  • bitte dreh das Thermostat etwas höher
  • bitte mach es im Wohnzimmer kühler
  • bitte mach es in der Küche etwas kälter
  • bitte stell das Thermostat 5 グレード wärmer ein
  • bitte stell das Thermostat auf 21 グレード für Kühlen ein
  • Bitte Stell Das Thermostat auf 30 グレード
  • bitte stell die Temperatur im Schlafzimmer auf 20 グレード
  • dreh das Thermostat wärmer ビット
  • dreh die Temperatur im Schlafzimmer etwas nach oben
  • dreh die Temperatur um 5 グレード runter
  • erhöhebitte die Temperatur im Bad
  • erhöhe die Temperatur um 2 グレード
  • mach es im Wohnzimmer 2 グレード wärmer
  • senke die Temperatur im Wohnzimmer um 5 グレード
  • Stellbitte das Thermostat auf Kühlen
  • stell das Thermostat 5 グレード kälter ein
  • stell die Kühlung auf 20 グレード ein

en-US

  • 暖房モードをオフにします。
  • 変更 サーモスタット 暖房の冷却 70 ~ 80 の範囲
  • エコに変更 モード
  • リビングルームで冷却
  • 冷房 少し
  • サーモスタットの温度を上げる
  • サーモスタットを管理する 暖房 78
  • 2 度 暖かく
  • 温度を下げる 2 度
  • サーモスタット ウォーム 少し
  • 冷房 モード
  • サーモスタット on クール
  • 温度を上げる 1 階 by 2 度
  • サーモスタットの温度を上げる 5 度
  • サーモスタット 70 度 on サーモスタット
  • 暖房・冷房 モード 62 ~ 79 度
  • 温度を設定 80 度
  • 暖房 72
  • 温度を cool で設定します。 70
  • サーモスタットを設定する。 70 クール モード
  • 下げる 5 度 オン サーモスタット
  • リビングルーム 温度 2 度
  • サーモスタットをオフにする 暖房 モード
  • ターン サーモスタット 少し
  • ターン サーモスタット
  • ウォームアップ リビングルーム
  • ウォームアップ リビングルーム 少し

es-ES

  • 25 grades de frío en ラ コシナ
  • Ajustar el termostato 21 年 21 年卒業生
  • Ajustar la temperatura entre 21 y 27 grados(21 年 21 年卒業生)
  • activar el modo calefacción
  • apagar el aire acondicionado del termostato
  • aumenta 10 grades la temperatura del horno
  • aumenta la temperatura de la cocina
  • baja algo la calefacción
  • baja la temperatura 5 grades
  • baja la temperatura del termostato
  • configurar el modo calefacción
  • Disminuye la temperatura de la cocina un poco
  • hace demasiado calaquí
  • me ajustas a 25 卒業生 el modo カロリー
  • me gustaría ajustar el termostato del salón a 25 卒業生 con la calefacción
  • ポン 20 卒業生 la temperatura
  • pon en modo calefacción el termostato de la cocina
  • pon la temperatura de la cocina a 20 卒業生向け
  • puedes subir un poco la temperatura en el salón
  • quiero bajar el nest 5 grades
  • quiero el modo aire acondicionado a 25 卒業生
  • quitar el modo frío del baño
  • sube 5 grados en la cocina
  • sube la calefacción
  • súbeme el termostato del salón un poquito
  • súbeme más la temperatura 10 gradeos

fr-FR

  • Allumer le mode chaud .
  • Meet en mode chaud .
  • Mets la température entre 21 et 23 degrés .
  • Mets la température à 17 度 .
  • メットルモード フロイド デュ サーモスタット à 19 度 .
  • メーター制度 froid à 19 度 .
  • Mettre le thermostat entre 70 et 80 degrés .
  • レグラーレモード chaud du サーモスタット à 22 度 .
  • レグラー レ モード chaud à 22 度 .
  • エンハンス ラ テンペラチュア デ 2 度
  • 拡張 un peu la température dans la chambre
  • baisse la température de ラ シャンブレ
  • baisse le thermostat
  • baisse un peu la température dans la 料理
  • baisse un peu le thermostat
  • baisser le thermostat de 5 度
  • クーペ レモード chaud
  • desces la température de 3 度
  • désactiver le mode frais du サーモスタット
  • meets le thermostat en モード frais
  • meets le thermostat à 10 度
  • メートル 2 度 de moins dans ラ 料理
  • monte la température de la chambre
  • monte la température de la salle de bain de 3 度
  • monte le thermostat
  • monte le thermostat de 2 度
  • monte un peu le thermostat
  • éteins le mode chaud du サーモスタット .

デバイスエラー

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