action.devices.traits.TemperatureControl – Đặc điểm của các thiết bị (ngoài máy điều nhiệt) hỗ trợ việc kiểm soát nhiệt độ, trong hoặc xung quanh thiết bị.
Điều này khác với đặc điểm TemperatureSetting, dành riêng cho các chế độ điều khiển kiểu máy điều nhiệt. Thuộc tính TemperatureSetting thể hiện nhiệt độ môi trường xung quanh (trong phòng/ngoài trời) và không được dùng để kiểm soát nhiệt độ của một thiết bị cụ thể. Để kiểm soát nhiệt độ của một thiết bị cụ thể, bạn phải sử dụng đặc điểm TemperatureControl.
Lưu ý: Tất cả lượt chuyển đổi giữa độ F và độ C sẽ được làm tròn đến độ hoặc nửa độ gần nhất tương ứng, trong dữ liệu đầu vào/đầu ra cho người dùng. Tất cả nhiệt độ đều được truyền theo độ C.
Thuộc tính thiết bị
Các thiết bị có đặc điểm này có thể báo cáo các thuộc tính sau đây trong quá trình thực hiện thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.
Thuộc tính Loại Mô tả temperatureRange Đối tượng
Bắt buộc.
Phạm vi nhiệt độ được hỗ trợ của thiết bị.
minThresholdCelsius Number
Bắt buộc.
Nhiệt độ tối thiểu của phạm vi, tính bằng độ C.
maxThresholdCelsius Number
Bắt buộc.
Nhiệt độ tối đa của phạm vi, tính bằng độ C.
temperatureStepCelsius Number
Chỉ định bước nhiệt độ tương đối. Đây là khoảng thời gian điều chỉnh tối thiểu mà thiết bị hỗ trợ. Nếu bạn không chỉ định, các bước tương đối sẽ được tính theo tỷ lệ phần trăm của temperatureRange.
temperatureUnitForUX String
Bắt buộc.
Đơn vị nhiệt độ dùng trong câu trả lời cho người dùng.
Các giá trị được hỗ trợ:
C F commandOnlyTemperatureControl Boolean
(Mặc định: false)
Cho biết liệu thiết bị có hỗ trợ giao tiếp một chiều (true) hay hai chiều (false) hay không. Đặt thuộc tính này thành true nếu thiết bị không thể phản hồi ý định QUERY hoặc Báo cáo trạng thái cho đặc điểm này.
queryOnlyTemperatureControl Boolean
(Mặc định: false)
Bắt buộc nếu thiết bị hỗ trợ chỉ thực thi truy vấn. Thuộc tính này cho biết liệu bạn chỉ có thể truy vấn thông tin trạng thái của thiết bị và không thể điều khiển thiết bị hay không.
Ví dụ
Thiết bị hỗ trợ chế độ điều khiển trong khoảng từ 150 đến 500 độ F, tăng dần 5 độ.
{ “temperatureRange”: { “minThresholdCelsius”: 65.5, “maxThresholdCelsius”: 260 }, “temperatureStepCelsius”: 2.778, “temperatureUnitForUX”: “F” }
Trạng thái thiết bị
Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong quá trình thực hiện thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần Thực hiện ý định.
Tiểu bang Loại Mô tả temperatureSetpointCelsius Number
Điểm đặt nhiệt độ hiện tại, tính bằng độ C. Phải nằm trong temperatureRange. Bắt buộc nếu queryOnlyTemperatureControl được đặt thành false
temperatureAmbientCelsius Number
Nhiệt độ được quan sát hiện tại, tính bằng độ C. Phải nằm trong temperatureRange.
Ví dụ
Thiết bị đang đặt ở nhiệt độ bao nhiêu?
{ “temperatureSetpointCelsius”: 150 }
LỆNH của thiết bị
Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem phần Thực hiện ý định.
action.devices.commands.SetTemperature
Đặt nhiệt độ thành một giá trị cụ thể.
Thông số
Thông số Loại Mô tả temperature Number
Bắt buộc.
Nhiệt độ cần đặt, tính bằng độ C. Phải nằm trong temperatureRange.
Ví dụ
Đặt thiết bị ở mức 350 độ F.
{ “command”: “action.devices.commands.SetTemperature”, “params”: { “temperature”: 176.67 } }
Lỗi liên quan
Đã xảy ra lỗi khi thiết lập nhiệt độ mục tiêu.
Các giá trị được hỗ trợ:
alreadyAtMax alreadyAtMin valueOutOfRange
Câu lệnh mẫu
Đây là mẫu của các câu lệnh được hỗ trợ bởi đặc điểm thiết bị này. Hãy nhớ xem xét các ngôn ngữ được hỗ trợ khác.
LỖI thiết bị
Xem danh sách đầy đủ lỗi và ngoại lệ.