Schema für EnergyStorage Trait für Smart Home

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äte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute	Typ	Beschreibung
queryOnlyEnergyStorage	Boolesch	Erforderlich. Wahr, wenn dieses Gerät nur Abfragen des gespeicherten Energielevels und optional des aktiven Ladestatus (abhängig vom isRechargeable-Attribut) unterstützt, das Starten und Beenden des Ladevorgangs jedoch nicht unterstützt werden.
energyStorageDistanceUnitForUX	String	(Standardeinstellung: "KILOMETERS") Wird in Antworten an den Nutzer verwendet. Unterstützte Werte: KILOMETERS MILES
isRechargeable	Boolesch	(Standardeinstellung: false) Wird auf „true“ gesetzt, wenn dieses Gerät wiederaufladbar ist. Das bedeutet, dass das Gerät den Status capacityUntilFull, isCharging und optional isPluggedIn melden kann und den Befehl Charge akzeptieren kann.

Beispiele

Aufladbares Gerät

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

Aufladbares Gerät, das den aktuellen Akkustand in Meilen anzeigt

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

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

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

Gerät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Bundesstaaten	Typ	Beschreibung
descriptiveCapacityRemaining	String	Erforderlich. Eine qualitative Beschreibung des Energiekapazitätslevels. Dies ist der Fall, wenn keine numerischen Kapazitätsdaten vorhanden sind. Wenn auch numerische Kapazitätsdaten verfügbar sind, sollten diese nach Möglichkeit gegenüber beschreibenden Daten bevorzugt werden. Unterstützte Werte: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	Array	Array von Einheit/Wert-Paaren, die Informationen über die aktuelle Energiekapazität des Geräts enthalten. Beispiel: Wie viele Kilometer legt mein <device> aktuell habe oder Wie viel Prozent lädt mein <device>
[item, ...]	Objekt	Verbleibende Kapazität in Einheit/Wert-Paar.
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 Einheit/Wert-Paaren, die Informationen über die Kapazität enthalten, bis das Gerät vollständig geladen ist. Beispiel: Wie lange dauert es noch, 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 gerade angeschlossen ist. Das Gerät kann an eine Stromquelle angeschlossen werden, lädt aber nicht aktiv.

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, das den aktuellen Akkustand in Meilen 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 Ladestatus unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

action.devices.commands.Charge

Starten oder beenden Sie den Ladevorgang.

Für diesen Befehl sind folgende Attribute erforderlich:

{
  "isRechargeable": true
}

Parameter

Parameter	Typ	Beschreibung
charge	Boolesch	Erforderlich. True, um den Ladevorgang zu starten, false, um den Ladevorgang zu beenden.

Beispiele

Ladebefehl starten

{
  "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 nicht angeschlossenes Gerät aufzuladen.