智慧型住宅 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 }
裝置狀態:STATE
具有此特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱意圖執行要求一文。
州 | 類型 | 說明 |
---|---|---|
descriptiveCapacityRemaining |
字串 |
必填。 能源容量等級的定性說明。請注意,如果沒有任何數值容量資料,則適用這個選項。如果有可用的數值容量資料,請盡可能採用描述性資料。 支援的值:
|
capacityRemaining |
陣列 |
一組裝置/值組,用於保存裝置目前擁有的能量容量資訊。例如:「我的 <裝置> 目前有多少英里」或「<裝置> 目前有多少百分比的費用?」 |
[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 |
布林 |
必填。 開始充電時為 True,停止充電時則為 False。 |
範例
開始充電
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
停止充電指令
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
裝置錯誤:ERRORS
請參閱錯誤和例外狀況的完整清單。deviceUnplugged
:使用者嘗試為未連接的裝置充電。