Hướng dẫn về tủ đông cho nhà thông minh
action.devices.types.FREEZER
– Máy đông là các thiết bị quản lý nhiệt độ có thể được điều chỉnh theo nhiều chế độ cài đặt và có thể cho phép theo dõi nhiệt độ.
Loại này cho biết thiết bị sẽ nhận được biểu tượng Ngăn đông và một số từ đồng nghĩa và biệt hiệu có liên quan.
Khả năng của thiết bị
Hãy tham khảo tài liệu về đặc điểm tương ứng để biết thông tin chi tiết về cách triển khai, chẳng hạn như các thuộc tính và trạng thái mà dịch vụ của bạn cần hỗ trợ cũng như cách tạo các phản hồi EXECUTE và QUERY.
Trait bắt buộc
Những đặc điểm và lệnh này là bắt buộc, nếu áp dụng cho thiết bị của bạn. Nếu thiết bị của bạn không hỗ trợ các trait này, hãy nhập mã lỗi functionNotSupported
vào phản hồi QUERY hoặc EXECUTE. Hãy xem phần Lỗi và ngoại lệ để biết thêm thông tin.
Yêu cầu về chất lượng
- Độ trễ: phải nhỏ hơn hoặc bằng 3000 mili giây.
- Độ tin cậy: phải lớn hơn hoặc bằng 97%.
Thiết bị ví dụ: Tủ đông đơn giản
Phần này trình bày các tải trọng ý định mẫu đại diện cho một "Bộ đóng băng" phổ biến dựa trên loại thiết bị và đặc điểm nêu trên. Nếu bạn thêm hoặc xoá đặc điểm trong quá trình triển khai, hãy sửa đổi các phản hồi cho phù hợp để phản ánh những thay đổi đó.
Phản hồi SYNC mẫu
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.FREEZER", "traits": [ "action.devices.traits.TemperatureControl" ], "name": { "name": "Simple freezer" }, "willReportState": true, "attributes": { "temperatureRange": { "minThresholdCelsius": -10, "maxThresholdCelsius": 5 }, "temperatureUnitForUX": "C" }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Phản hồi QUERY mẫu
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "temperatureSetpointCelsius": 0, "temperatureAmbientCelsius": 2 } } } }
Lệnh EXECUTE mẫu
SetTemperature
Để biết thêm thông tin chi tiết về các tham số lệnh, hãy xem tài liệu tham khảo về
action.devices.traits.TemperatureControl
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetTemperature", "params": { "temperature": 0 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "temperatureSetpointCelsius": 0, "temperatureAmbientCelsius": 2 } } ] } }