智慧型住宅 EnergyStorage 特徵結構定義

action.devices.traits.EnergyStorage - 這項特徵屬於可將能量儲存在電池中並可能充電的裝置，或是可為其他裝置充電的裝置。

裝置屬性

具有這項特徵的裝置可能會回報下列屬性，做為 SYNC 作業的一部分。如要進一步瞭解如何處理 SYNC 意圖，請參閱「意圖完成」。

屬性	類型	說明
queryOnlyEnergyStorage	布林值	必要。 如果裝置僅支援查詢儲存的電量，以及選用的充電狀態 (取決於 isRechargeable 屬性)，但不支援啟動和停止充電，則為 True。
energyStorageDistanceUnitForUX	String	(預設值："KILOMETERS") 這個名稱會用於回覆使用者的內容。 支援的值： KILOMETERS MILES
isRechargeable	布林值	(預設值：false) 如果這部裝置可充電，請設為 true。這表示裝置可能會回報 capacityUntilFull、isCharging 和 (選用) isPluggedIn 狀態，並可接受 Charge 指令。

範例

可充電裝置

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

可充電裝置，以英里顯示目前電量

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

無法充電的裝置，僅支援回報目前的電量

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

裝置狀態

具有這項特徵的實體可能會回報下列狀態，做為 QUERY 作業的一部分。如要進一步瞭解如何處理 QUERY 意圖，請參閱「意圖完成」。

州	類型	說明
descriptiveCapacityRemaining	String	必要。 能源容量等級的質性說明。請注意，這是指沒有數值容量資料的情況。如果也有數值容量資料，系統會盡可能優先採用這類資料，而非描述性資料。 支援的值： CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	陣列	裝置目前電量資訊的單位/值配對陣列。例如：我的「<裝置>」目前還能行駛多少英里或我的「<裝置>」目前電量百分比
[item, ...]	物件	以單位和值配對表示的剩餘容量。
rawValue	整數	必要。 容量值。
unit	String	必要。 容量單位。 支援的值： SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	陣列	裝置充飽電前，容量資訊的單位/值組陣列。例如：<裝置> 充飽電需要多久時間。
[item, ...]	物件	充電前容量。
rawValue	整數	必要。 容量值。
unit	String	必要。 容量單位。 支援的值： SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
isCharging	布林值	裝置目前是否正在充電。
isPluggedIn	布林值	裝置目前是否已接上電源。裝置可以接上電源，但未主動充電。

範例

可充電裝置

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

可充電裝置，以英里顯示目前電量

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

無法充電的裝置，僅支援回報目前的電量

{
  "descriptiveCapacityRemaining": "LOW"
}

裝置指令

具有這項特徵的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖，請參閱「意圖完成」。

action.devices.commands.Charge

開始或停止充電。

這項指令需要下列屬性：

{
  "isRechargeable": true
}

參數

參數	類型	說明
charge	布林值	必要。 設為 True 可開始充電，設為 False 則停止充電。

範例

開始充電指令

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

停止充電指令

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

裝置錯誤

請參閱「錯誤和例外狀況」的完整清單。

deviceUnplugged：使用者嘗試為未接上電源的裝置充電。