Google Home Developer Center へようこそ。スマートホーム アクションの開発方法を学習できます。注: アクションの構築は、引き続き Actions Console で行います。

スマートホーム TemperatureControl の特性スキーマ

action.devices.traits.TemperatureControl - デバイス内または周囲の温度管理に対応しているデバイス（サーモスタット以外のデバイス）のトレイト。

これは、特にサーモスタット スタイルのコントロール専用の TemperatureSetting トレイトとは異なります。TemperatureSetting トレイトは周囲（室外/屋外）の温度を表します。特定のデバイスの温度制御には使用しないでください。特定のデバイスの温度を制御するには、TemperatureControl トレイトを使用する必要があります。

デバイスの属性

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

属性 タイプ 説明
temperatureRange オブジェクト

必須。

デバイスでサポートされている温度範囲です。
minThresholdCelsius Number

必須。

範囲の最低温度（摂氏）。
maxThresholdCelsius Number

必須。

範囲の最高気温（摂氏）。
temperatureStepCelsius Number

相対温度ステップを指定します。これはデバイスでサポートされる最小調整間隔です。指定しない場合、相対ステップは temperatureRange の割合として計算されます。
temperatureUnitForUX 文字列

必須。

ユーザーへのレスポンスで使用される温度単位。

サポートされている値:

C
F
commandOnlyTemperatureControl ブール値

（デフォルト: false）

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

（デフォルト: false）

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

例

5 度単位で 150 ～ 500 度の範囲で制御できるデバイス

{
  "temperatureRange": {
    "minThresholdCelsius": 65.5,
    "maxThresholdCelsius": 260
  },
  "temperatureStepCelsius": 2.778,
  "temperatureUnitForUX": "F"
}

デバイスのステータス

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

状態 タイプ 説明
temperatureSetpointCelsius Number

現在の設定温度（摂氏）。temperatureRange 内である必要があります。queryOnlyTemperatureControl が false に設定されている場合は必須です
temperatureAmbientCelsius Number

現在観測中の気温（摂氏）。temperatureRange 内である必要があります。

例

デバイスに設定されている温度は？

{
  "temperatureSetpointCelsius": 150
}

デバイスのコマンド

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

action.devices.commands.SetTemperature

温度を特定の値に設定します。

パラメータ

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

必須。

設定する温度（摂氏）。temperatureRange 内である必要があります。

例

デバイスを 350 度（華氏）に設定します。

{
  "command": "action.devices.commands.SetTemperature",
  "params": {
    "temperature": 176.67
  }
}

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

サポートされている値:

alreadyAtMax
alreadyAtMin
valueOutOfRange

サンプル音声

de-DE

  • Erhöhe die Temperatur des Ofens
  • Stelle die Temperatur des Ofens auf 425 Grad
  • Wie warm ist der Ofen

en-US

  • I want the temperature of the oven higher
  • current temperature in the fridge
  • set the oven to 400

es-ES

  • pon la temperatura del horno a 180 grados
  • sube la temperatura del horno
  • ¿A qué temperatura está el horno ?

fr-FR

  • Le four est à quelle température ?
  • Mets la température du four à 180 degrés .
  • augmente la température du four

hi-IN

  • ओवन का टेम्परेचर कितना है
  • ओवन का तापमान 425 डिग्री पर करें

it-IT

  • Alza la temperatura del forno
  • Qual è la temperatura del frigo ?
  • metti il forno a 200 gradi

ja-JP

  • オーブン の温度は何度
  • オーブン の温度を 425度 に設定して
  • オーブン の温度を上げて

ko-KR

  • 오븐 온도 180 도로 맞춰
  • 오븐 온도 몇 도야
  • 오븐 온도 좀 높여 줄래

nl-NL

  • stel de oven in op 220 graden
  • verhoog de temperatuur van de oven
  • wat is de temperatuur van de oven

pt-BR

  • Diz-me qual é a temperatura da sala
  • Qual é a temperatura do forno ?
  • ajuste a temperatura do forno para 180 graus
  • aumenta a temperatura do forno
  • aumentar a temperatura do forno
  • define a temperatura do termostato nos 22 graus

sv-SE

  • Vad är det för temperatur i ugnen ?
  • höj temperaturen i ugnen
  • sätt ugnen på 100 grader

デバイスエラー

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