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äteattribute

Geräte mit diesem Merkmal können die folgenden Attribute als Teil des SYNC-Vorgangs melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
queryOnlyEnergyStorage Boolesch

Erforderlich.

„Wahr“, wenn dieses Gerät nur Abfragen zu den gespeicherten Energieniveaus und optional zum aktiven Ladestatus (abhängig vom Attribut isRechargeable) unterstützt, aber das Starten und Beenden des Ladevorgangs nicht.
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

Akkubetriebenes Gerät

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

Akkus, die den aktuellen Akkustand in Kilometern anzeigen

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

Nicht wiederaufladbares Gerät, das nur die aktuelle Akkukapazität meldet

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

GERÄTESTATUS

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

Bundesstaaten Typ Beschreibung
descriptiveCapacityRemaining String

Erforderlich.

Eine qualitative Beschreibung des Energiekapazitätsniveaus. Hinweis: Dieser Wert wird verwendet, wenn keine numerischen Kapazitätsdaten vorhanden sind. Wenn auch numerische Kapazitätsdaten verfügbar sind, werden diese nach Möglichkeit den beschreibenden Daten vorgezogen.

Unterstützte Werte:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining Array

Array von Einheit/Wert-Paaren mit Informationen zur aktuellen Energiekapazität des Geräts. Beispiel: Wie viele Kilometer hat mein <Gerät> noch oder Wie viel Prozent Akkustand hat mein <Gerät>
[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 Maßeinheit/Wert-Paaren mit Informationen zur Kapazität, bis das Gerät vollständig aufgeladen 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 derzeit angeschlossen ist. Das Gerät kann angeschlossen sein, wird aber nicht aktiv geladen.

Beispiele

Akkubetriebenes Gerät

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

Akkus, die den aktuellen Akkustand in Kilometern anzeigen

{
  "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 Akkustands unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

BEFEHLE für Geräte

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausfü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 den Ladevorgang zu starten, false, um den Ladevorgang 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

Eine vollständige Liste der Fehler und Ausnahmen

deviceUnplugged: Der Nutzer hat versucht, ein nicht angeschlossenes Gerät aufzuladen.