Schema für die Energiespeicherung von Smart Homes

action.devices.traits.EnergyStorage – Diese Eigenschaft gehört zu Geräten, die Energie in einem Akku speichern und möglicherweise aufladen können, oder zu Geräten, die ein anderes Gerät laden können.

Gerät ATTRIBUTE

Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute	Typ	Beschreibung
queryOnlyEnergyStorage	Boolesch	Erforderlich. Dieser Wert ist „True“, wenn das Gerät nur Abfragen zu den gespeicherten Energiepegeln und optional zum aktiven Ladestatus unterstützt (abhängig vom isRechargeable-Attribut), aber das Starten und Beenden des Ladevorgangs nicht unterstützt.
energyStorageDistanceUnitForUX	String	(Standard: "KILOMETERS") Wird als Antwort auf den Nutzer verwendet. Unterstützte Werte: KILOMETERS MILES
isRechargeable	Boolesch	(Standard: false) Setze den Wert auf „true“, wenn das Gerät wiederaufladbar ist. Das bedeutet, dass das Gerät möglicherweise den Status capacityUntilFull, isCharging und optional isPluggedIn meldet und den Befehl Charge akzeptieren kann.

Beispiele

Aufladbares Gerät

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

Aufladbares Gerät, auf dem der aktuelle Akkustand in Meilen angezeigt wird

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

Nicht tragbares Gerät, das nur die Anzeige des aktuellen Ladestands unterstützt

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

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten	Typ	Beschreibung
descriptiveCapacityRemaining	String	Erforderlich. Eine qualitative Beschreibung der Energiekapazität. Das ist der Fall, wenn keine numerischen Kapazitätsdaten vorhanden sind. Wenn auch numerische Kapazitätsdaten verfügbar sind, werden sie nach Möglichkeit gegenüber der Beschreibung bevorzugt. Unterstützte Werte: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Array	Array mit Einheiten/Wert-Paaren, die Informationen über die momentan vom Gerät enthaltene Energiekapazität enthalten. Beispiele: Wie viele Kilometer hat mein <device> momentan oder Wie viel Prozent meines Akkus hat mein <device>?
[item, ...]	Objekt	Verbleibende Kapazität in Einheits- 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 mit Einheiten/Wert-Paaren, die Informationen über die Kapazität enthalten, bis das Gerät vollständig geladen ist Beispiel: Wie lange dauert es, bis <device> vollständig aufgeladen ist?
[item, ...]	Objekt	Kapazität bis zum Aufladen.
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 momentan angeschlossen ist. Das Gerät kann angeschlossen werden, aber nicht aktiv geladen werden.

Beispiele

Aufladbares Gerät

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

Aufladbares Gerät, auf dem der aktuelle Akkustand in Meilen angezeigt wird

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

Nicht tragbares Gerät, das nur die Anzeige des aktuellen Ladezustands unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

Gerätebefehle

Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.Charge

Starten oder beenden Sie den Ladevorgang.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "isRechargeable": true
}

Parameter

Parameter	Typ	Beschreibung
charge	Boolesch	Erforderlich. Mit „true“ wird der Ladevorgang gestartet, mit „false“ wird der Ladevorgang beendet.

Beispiele

Ladebefehl starten

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

Ladebefehl beenden

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

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen

deviceUnplugged: Der Nutzer hat versucht, ein Gerät zu laden, das nicht an die Stromversorgung angeschlossen ist.