Sơ đồ về Trait của bộ nhớ năng lượng nhà thông minh

action.devices.traits.EnergyStorage – Đặc điểm này thuộc về các thiết bị có thể lưu trữ năng lượng trong pin và có khả năng sạc lại, hoặc thuộc về các thiết bị có thể sạc một thiết bị khác.

ATTRIBUTE của thiết bị

Những thiết bị có đặc điểm này có thể báo cáo những điều sau trong thao tác SYNC. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem Thực hiện ý định.

Thuộc tính	Loại	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 đã 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 isRechargeable), nhưng không hỗ trợ tính năng bắt đầu và dừng sạc.
energyStorageDistanceUnitForUX	String	(Mặc định: "KILOMETERS") Sẽ được dùng để trả lời người dùng. Các giá trị được hỗ trợ: KILOMETERS MILES
isRechargeable	Boolean	(Mặc định: false) Đặt thành true nếu thiết bị này có thể sạc lại được. Điều này cho biết thiết bị có thể báo cáo trạng thái capacityUntilFull, isCharging và isPluggedIn (không bắt buộc) cũng như có thể chấp nhận lệnh Charge.

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ợ tính năng báo cáo mức sạc hiện tại

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

Thiết bị STATES

Đối tượng có đặc điểm này có thể báo cáo những nội dung sau các trạng thái trong thao tác QUERY. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem Thực hiện ý định.

Tiểu bang	Loại	Mô tả
descriptiveCapacityRemaining	String	Bắt buộc. Nội dung mô tả định tính về mức công suất năng lượng. Lưu ý rằng điều này được áp dụng khi không có dữ liệu về dung lượng dạng số. Nếu dữ liệu về hạn mức dạng số cũng có sẵn, thì dữ liệu này sẽ được ưu tiên hơn so với dữ liệu mô tả khi có thể. Các giá trị được hỗ trợ: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Mảng	Mảng các cặp đơn vị/giá trị chứa thông tin về dung lượng năng lượng mà thiết bị hiện đang nắm giữ. Ví dụ: <device> của tôi mất bao nhiêu dặm hiện có hoặc <device> của tôi đang sạc bao nhiêu phần trăm có
[item, ...]	Đối tượng	Dung lượng còn lại theo đơn vị và cặp giá trị.
rawValue	Số nguyên	Bắt buộc. Giá trị hạn mức.
unit	String	Bắt buộc. Đơn vị dung lượng. Các giá trị được hỗ trợ: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	Mảng	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ì đến <device> đã sạc đầy.
[item, ...]	Đối tượng	Dung lượng cho tới khi sạc.
rawValue	Số nguyên	Bắt buộc. Giá trị hạn mức.
unit	String	Bắt buộc. Đơn vị dung lượng. Các giá trị được hỗ trợ: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	Boolean	Liệu thiết bị có đang sạc hay không.
isPluggedIn	Boolean	Xem thiết bị hiện đã được cắm nguồn hay chưa. Thiết bị có thể đã cắm điện nhưng không 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 mà chỉ hỗ trợ tính năng báo cáo mức sạc hiện tại

{
  "descriptiveCapacityRemaining": "LOW"
}

lệnh của thiết bị

Những thiết bị có đặc điểm này có thể phản hồi với những đặc điểm sau các lệnh trong thao tác EXECUTE. Để tìm hiểu tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy xem 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	Mô tả
charge	Boolean	Bắt buộc. Đặt là true để bắt đầu sạc, false để dừng sạc.

Ví dụ

Lệnh bắt đầu 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 toàn bộ danh sách lỗi và ngoại lệ.

deviceUnplugged: Người dùng đã cố sạc một thiết bị không được cắm điện.