智慧型住宅能源儲存空間特徵結構定義

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	陣列	裝置電池充飽電前，容量使用資訊的單位/值組合陣列。例如：「距離 <device> 還要多久才會充飽」。
[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：使用者嘗試為未接上電源的裝置充電。