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ó thể sạc lại, hoặc các thiết bị có thể sạc cho thiết bị khác.

Thuộc tính 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 thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem bài viết 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 được lưu trữ và trạng thái sạc đang hoạt động (không bắt buộc) nhưng không hỗ trợ việc bắt đầu và dừng sạc.
energyStorageDistanceUnitForUX String

(Mặc định: "KILOMETERS")

Sẽ được dùng trong các câu trả lời cho 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. Đ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ị sạc lại hiển thị mức pin hiện tại theo 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

Các thực thể có đặc điểm này có thể báo cáo các trạng thái sau đây trong thao tác QUERY. Để tìm hiểu thêm về cách xử lý ý định QUERY, hãy xem phần 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 năng lượng. Xin lưu ý rằng đây là trường hợp 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 có. Ví dụ: <device> của tôi hiện có bao nhiêu dặm hoặc <device> của tôi đã sạc được bao nhiêu phần trăm
[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 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ị sạc đầy. Ví dụ: Mất bao lâu để <thiết bị> 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 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

Thiết bị có đang cắm sạc hay không. Thiết bị có thể được cắm nguồn nhưng khô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ị sạc lại hiển thị mức pin hiện tại theo 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 pin hiện tại

{
  "descriptiveCapacityRemaining": "LOW"
}

LỆNH thiết bị

Các thiết bị có đặc điểm này có thể phản hồi các lệnh sau đây trong quá trình hoạt động EXECUTE. Để tìm hiểu thêm về cách xử lý ý định EXECUTE, hãy 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 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
  }
}

LỖI thiết bị

Xem danh sách đầy đủ các lỗi và ngoại lệ.

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