Hướng dẫn chung về nhà thông minh
action.devices.types.BLANKET – Các hoạt động tương tác với chăn thông minh có thể bao gồm bật và tắt, điều chỉnh nhiệt độ và/hoặc thiết lập nhiều chế độ và nút bật/tắt.
Loại này cho biết thiết bị nhận được biểu tượng Chăn và một số từ đồng nghĩa cũng như tên thay thế có liên quan.
Khả năng của thiết bị
Tham khảo tài liệu về đặc điểm tương ứng để biết thông tin chi tiết về việc 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 phải hỗ trợ, cũng như cách tạo phản hồi EXECUTE và QUERY.
Đặc điểm nên có
Bạn nên sử dụng những đặc điểm này nếu thiết bị của bạn có hỗ trợ. Tuy nhiên, bạn có thể tự do kết hợp các đặc điểm có sẵn để phù hợp nhất với chức năng sản phẩm hiện có.
Ví dụ về thiết bị: Chăn
Phần này chứa các tải trọng ý định mẫu đại diện cho một "Blanket" (Lớp phủ) phổ biến dựa trên loại thiết bị và đặc điểm ở trên. Nếu bạn thêm hoặc xoá các đặ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.BLANKET", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.Modes", "action.devices.traits.Toggles" ], "name": { "name": "Blanket" }, "willReportState": true, "attributes": { "availableModes": [ { "name": "temp_mode", "name_values": [ { "name_synonym": [ "Temperature", "Temp" ], "lang": "en" } ], "settings": [ { "setting_name": "hot_temp", "setting_values": [ { "setting_synonym": [ "Hot" ], "lang": "en" } ] }, { "setting_name": "warm_temp", "setting_values": [ { "setting_synonym": [ "Warm" ], "lang": "en" } ] } ] } ], "availableToggles": [ { "name": "auto_off", "name_values": [ { "name_synonym": [ "Auto off" ], "lang": "en" } ] } ] }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Phản hồi mẫu của hàm QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "on": true, "currentModeSettings": { "temp_mode": "warm_temp" }, "currentToggleSettings": { "auto_off": true } } } } }
Ví dụ về các lệnh EXECUTE
OnOff
Để 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
action.devices.traits.OnOff.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
SetModes
Để 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
action.devices.traits.Modes.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "temp_mode": "hot_temp" } } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentModeSettings": { "temp_mode": "hot_temp" } } } ] } }
SetToggles
Để 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
action.devices.traits.Toggles.
{ "requestId": "6894439706274654520", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "auto_off": false } } } ] } ] } } ] }
{ "requestId": "6894439706274654520", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentToggleSettings": { "auto_off": false } } } ] } }