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 isRechargeable), nhưng không hỗ trợ bắt đầu và dừng sạc.
energyStorageDistanceUnitForUX Chuỗi

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

Sẽ được dùng khi phản hồ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. Điều này cho biết rằng thiết bị có thể báo cáo trạng thái capacityUntilFull, isCharging và isPluggedIn (không bắt buộc), đồ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 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ợ:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
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ợ:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
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ợ:

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 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.