智慧型住宅 EnergyStorage 交易結構定義

action.devices.traits.EnergyStorage - 這個特性代表裝置能夠儲存電池供電，可能會為電池充電，或者可能會替其他裝置充電的裝置。

裝置屬性

具此特性的裝置可能會在 SYNC 作業中回報下列屬性。如要進一步瞭解如何處理 SYNC 意圖，請參閱意圖執行要求。

屬性	類型	說明
queryOnlyEnergyStorage	布林	必要。 如果這部裝置僅支援與儲存的能源量 (選用) 和/或充電狀態 (取決於 isRechargeable 屬性) 的查詢，則不支援開始和停止充電。
energyStorageDistanceUnitForUX	字串	(預設值："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	字串	必要。 能源能力等級的質量說明。請注意，這僅適用於沒有容量容量資料的情況。如果有可用容量資料，盡可能優先使用說明內容。 支援的值： CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	陣列	「裝置/值組」陣列，用於存放裝置目前所能耗能的能量。例如：我的 <device> 目前距離幾英里或 <裝置> 的電量是多少？
[item, ...]	物件	單位和值組的剩餘容量。
rawValue	整數	必要。 容量值。
unit	字串	必要。 容量單位。 支援的值： SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	陣列	用來表示容量資訊的單位/值陣列，直到裝置充飽電為止。例如：<裝置> 充電完成的時間。
[item, ...]	物件	充電時間。
rawValue	整數	必要。 容量值。
unit	字串	必要。 容量單位。 支援的值： 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	布林	必要。 開始充電時，傳回 false，停止充電。

範例

開始充電指令

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

停止充電指令

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

裝置 ERRORS

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

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