Giản đồ đặc điểm năng lượng của nhà thông minh
action.devices.traits.EnergyStorage
– Đặc điểm này thuộc về các thiết bị có thể dự trữ năng lượng trong pin và có khả năng sạc lại hoặc các thiết bị có thể sạc thiết bị khác.
THUỘC TÍNH của 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 SYNC
. Để tìm hiểu thêm về cách xử lý ý định SYNC
, vui lòng xem phần Thực hiện ý định.
Thuộc tính | Loại | Nội dung mô tả |
---|---|---|
queryOnlyEnergyStorage |
Boolean |
Bắt buộc. Đúng nếu thiết bị này chỉ hỗ trợ các truy vấn về mức năng lượng được lưu trữ và trạng thái sạc đang hoạt động (không bắt buộc) (phụ thuộc vào thuộc tính |
energyStorageDistanceUnitForUX |
Chuỗi |
(Mặc định: Sẽ được dùng khi phản hồi người dùng. Các giá trị được hỗ trợ:
|
isRechargeable |
Boolean |
(Mặc định: Đặt thành true nếu thiết bị này có thể sạc lại. Điều này cho biết rằng thiết bị có thể báo cáo trạng thái |
Ví dụ
Thiết bị có thể sạc lại
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
Thiết bị có thể sạc lại cho biết mức sạc hiện tại tính bằng dặm
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
Thiết bị không thể sạc lại chỉ hỗ trợ báo cáo mức phí hiện tại
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
TRẠNG THÁI của 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 trong thao tác QUERY
. Để tìm hiểu thêm về cách xử lý ý định QUERY
, vui lòng xem phần Thực hiện ý định.
Tiểu bang | Loại | Mô tả |
---|---|---|
descriptiveCapacityRemaining |
Chuỗi |
Bắt buộc. Nội dung mô tả định tính về mức công suất năng lượng. Xin lưu ý rằng điều này là dành cho trường hợp không có dữ liệu dung lượng dạng số. Nếu dữ liệu dung lượng dạng số cũng có sẵn, dữ liệu này sẽ được ưu tiên hơn so với mô tả khi có thể. Các giá trị được hỗ trợ:
|
capacityRemaining |
Mảng |
Một mảng các cặp đơn vị/giá trị chứa thông tin về công suất năng lượng mà thiết bị hiện đang chứa. Ví dụ: <device> hiện có bao nhiêu dặm hoặc <device> của tôi hiện có bao nhiêu phần trăm pin |
[item, ...] |
Đối tượng |
Dung lượng còn lại trong cặp đơn vị và giá trị. |
rawValue |
Số nguyên |
Bắt buộc. Giá trị dung lượng. |
unit |
Chuỗi |
Bắt buộc. Đơn vị dung lượng. Các giá trị được hỗ trợ:
|
capacityUntilFull |
Mảng |
Một mảng các cặp đơn vị/giá trị chứa thông tin về dung lượng cho đến khi thiết bị được sạc đầy. Ví dụ: Còn bao lâu nữa thì <device> sẽ được sạc đầy. |
[item, ...] |
Đối tượng |
Dung lượng cho đến khi sạc. |
rawValue |
Số nguyên |
Bắt buộc. Giá trị dung lượng. |
unit |
Chuỗi |
Bắt buộc. Đơn vị dung lượng. Các giá trị được hỗ trợ:
|
isCharging |
Boolean |
Liệu thiết bị có đang sạc hay không. |
isPluggedIn |
Boolean |
Thiết bị có đang được cắm nguồn hay không. Có thể cắm thiết bị vào nguồn điện, nhưng không thể chủ động sạc. |
Ví dụ
Thiết bị có thể sạc lại
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Thiết bị có thể sạc lại cho biết mức sạc hiện tại tính bằng dặm
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
Thiết bị không thể sạc lại chỉ hỗ trợ báo cáo mức sạc hiện tại
{ "descriptiveCapacityRemaining": "LOW" }
Lệnh trên thiết bị
Các thiết bị có trait này có thể phản hồi các lệnh sau đây trong quá trình thao tác EXECUTE
. Để tìm hiểu thêm về cách xử lý ý định EXECUTE
, vui lòng xem phần Thực hiện ý định.
action.devices.commands.Charge
Bắt đầu hoặc dừng sạc.
Lệnh này yêu cầu các thuộc tính sau:{ "isRechargeable": true }
Thông số
Thông số | Loại | Nội dung mô tả |
---|---|---|
charge |
Boolean |
Bắt buộc. True để bắt đầu sạc, false để dừng sạc. |
Ví dụ
Bắt đầu lệnh sạc
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
Lệnh dừng sạc
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
Thiết bị ERRORS
Xem danh sách đầy đủ lỗi và trường hợp ngoại lệ.deviceUnplugged
: Người dùng đã cố sạc một thiết bị chưa cắm sạc.