歡迎使用 Google Home 開發人員中心,探索全新功能,瞭解如何開發智慧住宅動作。注意:請繼續在「動作」控制台中建立動作。
透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

裝置屬性

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

屬性 類型 說明
queryOnlyEnergyStorage 布林

必填。

如果此裝置僅支援已儲存的電力等級和選用的充電狀態 (取決於 isRechargeable 屬性),但不支援開始和停止充電,則傳回 True。

energyStorageDistanceUnitForUX 字串

(預設:"KILOMETERS")

將用於回應使用者。

支援的值:

KILOMETERS
MILES
isRechargeable 布林

(預設:false)

如果此裝置可充電,請將值設為 True。這表示裝置可以回報 capacityUntilFullisCharging 和選用的 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:使用者嘗試為未連接的裝置充電。