Trang này được dịch bởi Cloud Translation API.

Giản đồ điểm đặt nhiệt độ của Thermostat

sdm.devices.traits.ThermostatTemperatureSetpoint

Đặc điểm này thuộc các loại thiết bị của NHIỆT ĐIỀU NHIỆT hỗ trợ đặt nhiệt độ mục tiêu và phạm vi nhiệt độ.

Trường

Trường	Mô tả	Loại dữ liệu
`heatCelsius`	Nhiệt độ mục tiêu tính theo độ C cho chế độ SƯỞI ẤM và HEATCOOL của máy điều nhiệt.	`number` Ví dụ: 20.0
`coolCelsius`	Nhiệt độ mục tiêu bằng độ C cho chế độ COOL và HEATCOOL của máy điều nhiệt.	`number` Ví dụ: 22.0

Phản hồi và yêu cầu GET mẫu – SƯỞI ẤM

Yêu cầu

GET /enterprises/project-id/devices/device-id

Phản hồi

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Phản hồi và yêu cầu GET mẫu – COOL

Yêu cầu

GET /enterprises/project-id/devices/device-id

Phản hồi

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Phản hồi và yêu cầu GET mẫu – HEATCOOL

Yêu cầu

GET /enterprises/project-id/devices/device-id

Phản hồi

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Lệnh

Máy điều nhiệt phải ở chế độ tương ứng với lệnh đang được gọi trước khi thay đổi điểm đặt nhiệt độ. Lệnh và(các) trường để thay đổi(các) điểm đặt sẽ khác nhau tuỳ theo máy điều nhiệt .

Ví dụ: để phát hành SetHeat thì trước tiên, máy điều nhiệt phải ở chế độ SƯỞI ẤM:

Chế độ	Lệnh	(Các) trường
BỔ SUNG	SetHeat	`heatCelsius`
TỐT	SetCool	`coolCelsius`
SƯỞI ẤM ẤM	SetRange	`heatCelsius`, `coolCelsius`

Lưu ý rằng các lệnh điểm đặt chỉ lấy độ trong C làm tham số, mặc dù Google Nest Thermostat có thể hiển thị nhiệt độ theo độ C hoặc độ F.

Các lệnh

SetHeat

Đặt nhiệt độ mục tiêu khi máy điều nhiệt ở chế độ SƯỞI ẤM.

Yêu cầu và phản hồi của SetHeat

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Phản hồi

{}

Trường yêu cầu SetHeat

Trường	Mô tả	Loại dữ liệu
`heatCelsius`	Nhiệt độ mục tiêu cần đặt khi máy điều nhiệt ở chế độ SƯỞI ẤM.	`number` Ví dụ: 22.0

SetCool

Đặt nhiệt độ mục tiêu khi máy điều nhiệt ở chế độ làm mát.

Yêu cầu và phản hồi SetCool

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

Phản hồi

{}

Trường yêu cầu SetCool

Trường	Mô tả	Loại dữ liệu
`coolCelsius`	Nhiệt độ mục tiêu cần đặt khi máy điều nhiệt ở chế độ làm mát.	`number` Ví dụ: 20.0

SetRange

Đặt nhiệt độ tối thiểu và tối đa khi máy điều nhiệt ở chế độ SƯỞI ẤM.

Yêu cầu và phản hồi Setrange

Yêu cầu

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

Phản hồi

{}

Trường yêu cầu Setrange

Trường	Mô tả	Loại dữ liệu
`heatCelsius`	Nhiệt độ mục tiêu tối thiểu cần đặt khi máy điều nhiệt ở chế độ SƯỞI ẤM.	`number` Ví dụ: 20.0
`coolCelsius`	Nhiệt độ mục tiêu tối đa cần đặt khi máy điều nhiệt ở chế độ SƯỞI ẤM.	`number` Ví dụ: 22.0

Lỗi

(Các) mã lỗi sau đây có thể được trả về liên quan đến đặc điểm này:

Thông báo Lỗi	RPC	Khắc phục sự cố
Không dùng được lệnh ở chế độ máy điều nhiệt hiện tại.	`FAILED_PRECONDITION`	Một số mẫu máy điều nhiệt không hỗ trợ thay đổi chế độ Tiết kiệm năng lượng khi chế độ máy điều nhiệt TẮT, theo tính năng ThermostatMode . Bạn phải chuyển máy điều nhiệt thành SƯỞI ẤM, LÀM MÁT hoặc SƯỞI ẤM trước khi chuyển sang chế độ Tiết kiệm năng lượng.
Giá trị làm mát phải lớn hơn giá trị nhiệt.	`INVALID_ARGUMENT`	Đảm bảo trường `heatCelsius` nhỏ hơn trường `coolCelsius` trong lệnh của bạn.
Không được phép dùng lệnh khi máy điều nhiệt ở chế độ MANUAL_ECO.	`FAILED_PRECONDITION`	Không thể đặt điểm đặt nhiệt độ khi máy điều nhiệt ở chế độ Tiết kiệm năng lượng thủ công.

Hãy xem Tài liệu tham khảo về mã lỗi API để biết danh sách đầy đủ các mã lỗi API.