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

action.devices.types.THERMOSTAT - 溫度控制器是管理溫度的裝置，可設定溫度和模式。這類裝置與暖氣機和空調不同，後者可能只有模式和設定 (例如高/低)，沒有目標溫度。

這類裝置會顯示溫度控制器圖示，以及一些相關的同義字和別名。

這類裝置可控制溫度，但部分暖氣/冷氣室內機有不同的控制選項和高/低模式，無法控制溫度。

裝置功能

如需實作詳細資料 (例如服務應支援的屬性和狀態，以及如何建構 EXECUTE 和 QUERY 回應)，請參閱相應的特徵說明文件。

必要特徵

如果適用於裝置，就必須提供這些特徵和指令。如果裝置不支援這些特徵，請在 QUERY 或 EXECUTE 回應中輸入 functionNotSupported 的錯誤代碼。詳情請參閱「錯誤和例外狀況」一節。

溫度控制器指令通常會以 EXECUTE 意圖鏈結。使用者說出「將暖氣設為 22 度」時，系統會產生模式指令，然後設定溫度。

範例裝置：簡易型溫度控制器

本節包含意圖酬載範例，代表常見的「溫度控制器」，並以上述裝置類型和特徵為依據。如果在實作中新增或移除特徵，請相應修改回覆，以反映這些變更。

SYNC 回應範例

要求
{
  "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 指令範例

ThermostatTemperatureSetpoint

如要進一步瞭解指令參數，請參閱 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
        }
      }
    ]
  }
}

ThermostatTemperatureSetRange

如要進一步瞭解指令參數，請參閱 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
        }
      }
    ]
  }
}

裝置錯誤

如需完整清單，請參閱錯誤和例外狀況。
  • inHeatOrCool - 裝置處於明確的加熱或冷卻狀態，因此「加熱」、「冷卻」或「範圍」指令失敗。
  • inHeatCool - 裝置處於加熱或冷卻狀態，因此「加熱」或「冷卻」指令失敗。
  • lockedToRange - 裝置已鎖定溫度範圍或模式，因此無法進行要求的變更。
  • rangeTooClose - 熱冷範圍的溫度點太接近。