Lược đồ đặc điểm Smart Home EnergyStorage

action.devices.traits.EnergyStorage – Đặc điểm này thuộc về những thiết bị có thể lưu trữ năng lượng trong pin và có thể sạc lại, hoặc những thiết bị có thể sạc cho 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 thao tác SYNC. Để tìm hiểu thêm về cách xử lý ý định SYNC, hãy xem phần Thực hiện ý định.

Thuộc tính Loại Mô tả
queryOnlyEnergyStorage Boolean

Bắt buộc.

True 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 (tuỳ thuộc vào thuộc tính isRechargeable), nhưng không hỗ trợ bắt đầu và dừng sạc.
energyStorageDistanceUnitForUX String

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

Sẽ được dùng trong 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à có thể là isPluggedIn, đồng thời 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, hiển thị mức sạc hiện tại theo dặm

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

Thiết bị không sạc được và chỉ hỗ trợ báo cáo mức sạc hiện tại

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

TRẠNG THÁI 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 đâ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 điều này áp dụng khi không có dữ liệu số về sức chứa. Nếu có cả dữ liệu về sức chứa bằng số, thì dữ liệu này sẽ được ưu tiên hơn dữ liệu mô tả (nếu có thể).

Các giá trị được hỗ trợ:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Mảng

Mảng gồm 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 đã đi được bao nhiêu dặm hoặc <device> của tôi đang sạc được bao nhiêu phần trăm
[item, ...] Đối tượng

Số lượng còn lại theo cặp đơn vị và giá trị.
rawValue Số nguyên

Bắt buộc.

Giá trị công suất.
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 gồm các cặp đơn vị/giá trị lưu giữ thông tin về dung lượng cho đến khi thiết bị sạc đầy. Ví dụ: Còn bao lâu nữa thì <device> 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ị công suất.
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

Thiết bị có đang sạc hay không.
isPluggedIn Boolean

Thiết bị hiện có cắm điện hay không. Thiết bị có thể cắm điệ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ị có thể sạc lại, hiển thị mức sạc 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 sạc được và 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ó đặc điểm này có thể phản hồi các lệnh sau đây trong thao tác 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.

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à trường hợp ngoại lệ.

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