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

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	陣列	陣列/值組合的陣列，其中保留裝置目前擁有的能量容量相關資訊。例如：我的 <device> 距離幾英里。目前或我的 <device> 電量百分比是多少同時具備
[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：使用者嘗試為未接上電源的裝置充電。