Schema für Eigenschaften von Smart Home-Energiespeichern

action.devices.traits.EnergyStorage – Dieses Merkmal gilt für Geräte, die Energie in einem Akku speichern und möglicherweise aufladen oder für Geräte, die ein anderes Gerät aufladen können.

Geräte-ATTRIBUTE

Geräte mit diesem Merkmal können im Rahmen des SYNC-Vorgangs die folgenden Attribute melden. Weitere Informationen zum Verarbeiten von 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 Energiewerten und optional dem aktiven Ladezustand (abhängig vom Attribut isRechargeable) unterstützt, aber das Starten und Beenden des Ladevorgangs nicht unterstützt.
energyStorageDistanceUnitForUX	String	(Standard: "KILOMETERS") Wird in Antworten des Nutzers verwendet Unterstützte Werte: KILOMETERS MILES
isRechargeable	Boolesch	(Standard: false) Wird auf „true“ gesetzt, wenn das Gerät wieder aufgeladen ist. Das bedeutet, dass das Gerät möglicherweise den Status capacityUntilFull, isCharging und optional isPluggedIn hat und auch den Befehl Charge akzeptieren kann.

Beispiele

Wiederaufladbares 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 reparierbares Gerät, das nur das Melden des aktuellen Akkustands unterstützt

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

Gerätestatus

Entitäten mit diesem Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Bundesstaaten	Typ	Beschreibung
descriptiveCapacityRemaining	String	Erforderlich. Eine qualitative Beschreibung des Energiekapazitäts. Dies 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 dem beschreibenden Wert bevorzugt. Unterstützte Werte: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Array	Array mit Wert/Wert-Paaren, die Informationen zur aktuellen Energiekapazität des Geräts enthalten. Beispiel: Wie viele Kilometer ist mein <Gerät> derzeit? oder Wie hoch ist die prozentuale Aufladung meines <Gerätes>?.
[item, ...]	Objekt	Verbleibende Kapazität im 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 Wert/Wert-Paaren, das Informationen über die Kapazität enthält, bis das Gerät vollständig geladen ist. Beispiel: Wie lange es dauert, bis <device> vollständig geladen 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 aufgeladen wird.
isPluggedIn	Boolesch	Gibt an, ob das Gerät momentan an die Stromversorgung angeschlossen ist. Das Gerät kann angeschlossen werden, 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
}

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 reparierbares Gerät, das nur das Melden des aktuellen Akkustands unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

BEISPIELE für Geräte

Geräte mit diesem Merkmal können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Verarbeiten von 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. True, um mit dem Laden zu beginnen, false, um das Laden zu beenden.

Beispiele

Ladebefehl starten

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

Ladebefehl stoppen

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

Gerät ERRORS

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.

deviceUnplugged: Der Nutzer hat versucht, ein Gerät zu laden, das nicht ans Stromnetz angeschlossen ist.