智慧型住宅能源儲存空間特徵結構定義
action.devices.traits.EnergyStorage
:這個特徵屬於可儲存電量並可能為其他裝置充電的裝置。
裝置屬性
具備這個特性的裝置可能會在 SYNC
作業中回報下列屬性。如要進一步瞭解如何處理 SYNC
意圖,請參閱「意圖執行要求」。
屬性 | 類型 | 說明 |
---|---|---|
queryOnlyEnergyStorage |
布林 |
必要。 如果這部裝置僅支援查詢預存能量等級,以及視需要啟用的充電狀態 (視 |
energyStorageDistanceUnitForUX |
String |
(預設值: 用來回應使用者。 支援的值:
|
isRechargeable |
布林 |
(預設值: 如果這部裝置可充電,請設為 true。這表示裝置可能會回報 |
範例
充電裝置
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
充電裝置,顯示目前電量 (以英里為單位)
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
僅支援回報目前電量等級的非充電裝置
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
裝置狀態
具有這個特性的實體可能會在 QUERY
作業中回報下列狀態。如要進一步瞭解如何處理 QUERY
意圖,請參閱「意圖執行要求」。
狀態 | 類型 | 說明 |
---|---|---|
descriptiveCapacityRemaining |
String |
必要。 能量容量的質性說明。請注意,這適用於沒有容量資料的情況。如果也有數字容量資料,系統會盡可能優先採用這些數值,而非描述性。 支援的值:
|
capacityRemaining |
陣列 |
裝置目前擁有的能源能力資訊的單位/值組合陣列。例如:「我的 <裝置> 目前有多少英里電量」或「我的 <裝置> 電量百分比」 |
[item, ...] |
物件 |
單位和值組合中的剩餘容量。 |
rawValue |
整數 |
必要。 容量值。 |
unit |
String |
必要。 容量單位。 支援的值:
|
capacityUntilFull |
陣列 |
裝置電池充飽電前,容量使用資訊的單位/值組合陣列。例如:「距離 <device> 還要多久才會充飽」。 |
[item, ...] |
物件 |
充電前的容量。 |
rawValue |
整數 |
必要。 容量值。 |
unit |
String |
必要。 容量單位。 支援的值:
|
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
:使用者嘗試為未接上電源的裝置充電。