智慧型住宅 EnergyStorage 交易結構定義
action.devices.traits.EnergyStorage
- 這個特性代表裝置能夠儲存電池供電,可能會為電池充電,或者可能會替其他裝置充電的裝置。
裝置屬性
具此特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱意圖執行要求。
屬性 | 類型 | 說明 |
---|---|---|
queryOnlyEnergyStorage |
布林 |
必要。 如果這部裝置僅支援與儲存的能源量 (選用) 和/或充電狀態 (取決於 |
energyStorageDistanceUnitForUX |
字串 |
(預設值: 將用於回應使用者的要求。 支援的值:
|
isRechargeable |
布林 |
(預設值: 如果這部裝置可供充電,請設為 true。這表示裝置可能會回報 |
範例
為裝置充電
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
充電裝置充電,顯示目前電量 (以英里為單位)
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
非充電裝置,只能回報目前的充電等級
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求。
州 | 類型 | 說明 |
---|---|---|
descriptiveCapacityRemaining |
字串 |
必要。 能源能力等級的質量說明。請注意,這僅適用於沒有容量容量資料的情況。如果有可用容量資料,盡可能優先使用說明內容。 支援的值:
|
capacityRemaining |
陣列 |
「裝置/值組」陣列,用於存放裝置目前所能耗能的能量。例如:我的 <device> 目前距離幾英里或 <裝置> 的電量是多少? |
[item, ...] |
物件 |
單位和值組的剩餘容量。 |
rawValue |
整數 |
必要。 容量值。 |
unit |
字串 |
必要。 容量單位。 支援的值:
|
capacityUntilFull |
陣列 |
用來表示容量資訊的單位/值陣列,直到裝置充飽電為止。例如:<裝置> 充電完成的時間。 |
[item, ...] |
物件 |
充電時間。 |
rawValue |
整數 |
必要。 容量值。 |
unit |
字串 |
必要。 容量單位。 支援的值:
|
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
:使用者嘗試為未接上電源的裝置充電。