歡迎來到 Google Home 開發人員中心,你可以在這裡學習如何學習智慧型住宅動作。注意事項:您將在 Actions 主控台建構動作。

智慧型住宅溫度控制器指南

action.devices.types.THERMOSTAT - 溫度控制器是溫度管理裝置,已設定 Point 和模式。這樣可以區分暖氣和空調 (可能僅有模式和設定,例如高/低) 與溫度目標。

這個類型表示裝置會取得 Dataproc 圖示,以及一些相關的同義詞和別名。

這個類型的裝置可控制溫度,而部分暖氣/冷氣單位單位有不同的控制項和高/低模式,但沒有溫度控制選項。

裝置功能

如需實作詳情,請參閱對應的屬性說明文件,例如服務必須支援的屬性和狀態,以及如何建構 EXECUTE 和 QUERY 回應。

必要特性

這些特性和指令 (如適用) 僅適用於您的裝置。

指令指令通常會鏈結至 EXECUTE 意圖中。使用者說出「將暖氣設為 72*」後會產生模式指令,後面接著設定溫度。

品質規定

  • 延遲時間:小於或等於 700 毫秒
  • 可靠性:大於或等於 97%

裝置範例:簡單溫度控制器

本節包含根據上述裝置類型和特性區分的常見「熱能」範例意圖酬載。如果您在實作中新增或移除特性,請據此調整回應。

同步處理回應範例

要求
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
回應
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.THERMOSTAT",
        "traits": [
          "action.devices.traits.TemperatureSetting"
        ],
        "name": {
          "name": "Simple thermostat"
        },
        "willReportState": true,
        "attributes": {
          "availableThermostatModes": [
            "off",
            "heat",
            "cool",
            "heatcool",
            "on"
          ],
          "thermostatTemperatureRange": {
            "minThresholdCelsius": 15,
            "maxThresholdCelsius": 30
          },
          "thermostatTemperatureUnit": "F"
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

QUERY 回應範例

要求
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
回應
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "thermostatMode": "cool",
        "thermostatTemperatureSetpoint": 23,
        "thermostatTemperatureAmbient": 25.1,
        "thermostatHumidityAmbient": 45.3
      }
    }
  }
}

EXECUTE 指令範例

DataprocTemperatureSetpoint

如要進一步瞭解指令參數,請參閱 action.devices.traits.TemperatureSetting 參考資料。

要求
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.ThermostatTemperatureSetpoint",
                "params": {
                  "thermostatTemperatureSetpoint": 22
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
回應
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "thermostatMode": "cool",
          "thermostatTemperatureSetpoint": 22,
          "thermostatTemperatureAmbient": 25.1
        }
      }
    ]
  }
}

DataprocTemperatureSetRange

如要進一步瞭解指令參數,請參閱 action.devices.traits.TemperatureSetting 參考資料。

要求
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.ThermostatTemperatureSetRange",
                "params": {
                  "thermostatTemperatureSetpointHigh": 26,
                  "thermostatTemperatureSetpointLow": 22
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
回應
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "thermostatMode": "heatcool",
          "thermostatTemperatureSetpointHigh": 26,
          "thermostatTemperatureSetpointLow": 22,
          "thermostatTemperatureAmbient": 25.1
        }
      }
    ]
  }
}

ThermostatSetMode

如要進一步瞭解指令參數,請參閱 action.devices.traits.TemperatureSetting 參考資料。

要求
{
  "requestId": "6894439706274654520",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.ThermostatSetMode",
                "params": {
                  "thermostatMode": "heatcool"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
回應
{
  "requestId": "6894439706274654520",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "thermostatMode": "heatcool",
          "thermostatTemperatureSetpointHigh": 26,
          "thermostatTemperatureSetpointLow": 22,
          "thermostatTemperatureAmbient": 25.1
        }
      }
    ]
  }
}

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。
  • inHeatOrCool - 裝置含有高熱或酷的冷氣,因此熱 • 冷/範圍指令失敗
  • inHeatCool - 裝置過熱或發電,因此無法啟動熱源或冷指令
  • lockedToRange - 裝置已鎖定在溫度範圍或模式下,且無法進行要求的變更。
  • rangeTooClose - 冷氣範圍的溫度點之間的距離太近。