歡迎來到 Google Home 開發人員中心,你可以在這裡學習如何學習智慧型住宅動作。注意事項:您將在 Actions 主控台建構動作。

智慧型住宅 EnergyStorage 交易結構定義

action.devices.traits.EnergyStorage - 這個特性代表裝置能夠儲存電池供電,可能會為電池充電,或者可能會替其他裝置充電的裝置。

裝置屬性

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

屬性 類型 說明
queryOnlyEnergyStorage 布林

必要。

如果這部裝置僅支援與儲存的能源量 (選用) 和/或充電狀態 (取決於 isRechargeable 屬性) 的查詢,則不支援開始和停止充電。

energyStorageDistanceUnitForUX 字串

(預設值:"KILOMETERS")

將用於回應使用者的要求。

支援的值:

KILOMETERS
MILES
isRechargeable 布林

(預設值:false)

如果這部裝置可供充電,請設為 true。這表示裝置可能會回報 capacityUntilFullisCharging 以及選用的 isPluggedIn 狀態,並接受 Charge 指令。

範例

為裝置充電

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

充電裝置充電,顯示目前電量 (以英里為單位)

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

非充電裝置,只能回報目前的充電等級

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱意圖執行要求

類型 說明
descriptiveCapacityRemaining 字串

必要。

能源能力等級的質量說明。請注意,這僅適用於沒有容量容量資料的情況。如果有可用容量資料,盡可能優先使用說明內容。

支援的值:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining 陣列

「裝置/值組」陣列,用於存放裝置目前所能耗能的能量。例如:我的 <device> 目前距離幾英里 <裝置> 的電量是多少?

[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 布林

必要。

開始充電時,傳回 false,停止充電。

範例

開始充電指令

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

停止充電指令

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

裝置 ERRORS

請參閱錯誤和例外狀況的完整清單。

deviceUnplugged:使用者嘗試為未接上電源的裝置充電。