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

action.devices.traits.EnergyStorage - 這個部位屬於可以充電的電池，且可能充電，或者可為其他裝置充電。

裝置屬性

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

屬性	類型	說明
queryOnlyEnergyStorage	布林	必填。 如果此裝置僅支援已儲存的電力等級和選用的充電狀態 (取決於 isRechargeable 屬性)，但不支援開始和停止充電，則傳回 True。
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
}

裝置狀態：STATE

具有此特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖，請參閱意圖執行要求一文。

州	類型	說明
descriptiveCapacityRemaining	字串	必填。 能源容量等級的定性說明。請注意，如果沒有任何數值容量資料，則適用這個選項。如果有可用的數值容量資料，請盡可能採用描述性資料。 支援的值： CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	陣列	一組裝置/值組，用於保存裝置目前擁有的能量容量資訊。例如：「我的 <裝置> 目前有多少英里」或「<裝置> 目前有多少百分比的費用？」
[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	布林	必填。 開始充電時為 True，停止充電時則為 False。

範例

開始充電

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

停止充電指令

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

裝置錯誤：ERRORS

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

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