Hướng dẫn về bộ sạc tại nhà thông minh
action.devices.types.CHARGER – Các hoạt động tương tác với bộ sạc có thể bao gồm bắt đầu và dừng sạc, cũng như kiểm tra mức sạc hiện tại, dung lượng còn lại và dung lượng cho đến khi đầy.
Loại này cho biết thiết bị nhận được biểu tượng Bộ sạc 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 bắt buộc
Bạn phải có những đặc điểm và lệnh này (nếu có) trên thiết bị của mình. Nếu thiết bị của bạn không hỗ trợ các đặc điểm này, hãy nhập mã lỗi functionNotSupported trong phản hồi QUERY hoặc EXECUTE. Hãy xem phần Lỗi và trường hợp ngoại lệ để biết thêm thông tin.
Ví dụ về thiết bị: Bộ sạc đơn giản
Phần này chứa các tải trọng ý định mẫu đại diện cho một "Bộ sạc" 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.CHARGER", "traits": [ "action.devices.traits.EnergyStorage" ], "name": { "name": "Simple charger" }, "willReportState": true, "attributes": { "isRechargeable": true, "queryOnlyEnergyStorage": false }, "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, "descriptiveCapacityRemaining": "MEDIUM", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "capacityUntilFull": [ { "unit": "SECONDS", "rawValue": 3600 } ], "isCharging": true } } } }
Ví dụ về các lệnh EXECUTE
Tính Phí
Để 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.EnergyStorage.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Charge", "params": { "charge": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "isCharging": false } } ] } }