Smart Home EnergyStorage-Trait-Schema

action.devices.traits.EnergyStorage: Dieses Attribut gehört zu Geräten, die Energie in einem Akku speichern und möglicherweise wieder aufladen können, oder zu Geräten, die ein anderes Gerät aufladen können.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zur Verarbeitung von SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
queryOnlyEnergyStorage Boolesch

Erforderlich.

„True“, wenn dieses Gerät nur Anfragen zu den gespeicherten Energieniveaus und optional zum aktiven Ladestatus (abhängig vom Attribut isRechargeable) unterstützt, aber nicht das Starten und Beenden des Ladevorgangs.
energyStorageDistanceUnitForUX String

(Standardeinstellung: "KILOMETERS")

Wird in Antworten an den Nutzer verwendet.

Unterstützte Werte:

KILOMETERS
MILES
isRechargeable Boolesch

(Standardeinstellung: false)

Auf „true“ setzen, wenn das Gerät wiederaufladbar ist. Das Gerät kann den Status capacityUntilFull, isCharging und optional isPluggedIn melden und den Befehl Charge akzeptieren.

Beispiele

Wiederaufladbares Gerät

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

Wiederaufladbares Gerät, das den aktuellen Ladestand in Kilometern anzeigt

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

Nicht wiederaufladbares Gerät, das nur die Meldung des aktuellen Ladestands unterstützt

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

Gerätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

Bundesstaaten Typ Beschreibung
descriptiveCapacityRemaining String

Erforderlich.

Eine qualitative Beschreibung des Energieleistungsniveaus. Das gilt, wenn keine numerischen Kapazitätsdaten vorhanden sind. Wenn auch numerische Kapazitätsdaten verfügbar sind, werden diese nach Möglichkeit gegenüber beschreibenden Daten bevorzugt.

Unterstützte Werte:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Array von Einheits-/Wert-Paaren mit Informationen zur aktuellen Energieleistung des Geräts. Beispiele: Wie viele Kilometer hat mein <device> derzeit zurückgelegt? oder Wie viel Prozent Akku hat mein <device>?
[item, ...] Objekt

Verbleibende Kapazität in Einheit und Wertpaar.
rawValue Ganzzahl

Erforderlich.

Der Kapazitätswert.
unit String

Erforderlich.

Die Kapazitätseinheit.

Unterstützte Werte:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

Array von Einheiten-/Wert-Paaren, die Informationen zur Kapazität bis zum vollständigen Aufladen des Geräts enthalten, z. B. Wie viel Zeit bis zum vollständigen Aufladen von <device>.
[item, ...] Objekt

Kapazität bis zur Aufladung.
rawValue Ganzzahl

Erforderlich.

Der Kapazitätswert.
unit String

Erforderlich.

Die Kapazitätseinheit.

Unterstützte Werte:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Boolesch

Gibt an, ob das Gerät gerade geladen wird.
isPluggedIn Boolesch

Gibt an, ob das Gerät derzeit eingesteckt ist. Das Gerät kann angeschlossen sein, wird aber nicht aktiv geladen.

Beispiele

Wiederaufladbares Gerät

{
  "descriptiveCapacityRemaining": "HIGH",
  "capacityRemaining": [
    {
      "rawValue": 36000,
      "unit": "SECONDS"
    },
    {
      "rawValue": 90,
      "unit": "PERCENTAGE"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 120,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Wiederaufladbares Gerät, das den aktuellen Ladestand in Kilometern anzeigt

{
  "descriptiveCapacityRemaining": "CRITICALLY_LOW",
  "capacityRemaining": [
    {
      "rawValue": 12,
      "unit": "MILES"
    }
  ],
  "capacityUntilFull": [
    {
      "rawValue": 6000,
      "unit": "SECONDS"
    }
  ],
  "isCharging": true,
  "isPluggedIn": true
}

Nicht wiederaufladbares Gerät, das nur die Meldung des aktuellen Ladestands unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

GERÄTEBEFEHLE

Geräte mit diesem Merkmal reagieren möglicherweise auf die folgenden Befehle im Rahmen des Vorgangs EXECUTE. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.Charge

Ladevorgang starten oder beenden

Für diesen Befehl sind die folgenden Attribute erforderlich: 
{
  "isRechargeable": true
}

Parameter

Parameter Typ Beschreibung
charge Boolesch

Erforderlich.

„True“, um den Ladevorgang zu starten, „false“, um ihn zu beenden.

Beispiele

Befehl zum Starten des Ladevorgangs

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

Befehl zum Beenden des Ladevorgangs

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

GERÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen

deviceUnplugged: Der Nutzer hat versucht, ein Gerät aufzuladen, das nicht angeschlossen ist.