Schema des EnergyStorage-Traits von Smart-Home-Geräten

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

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
queryOnlyEnergyStorage Boolesch

Erforderlich.

„True“, wenn dieses Gerät nur Abfragen zum gespeicherten Energiepegel und optional zum aktiven Ladestatus unterstützt (abhängig vom isRechargeable-Attribut), aber nicht das Starten und Stoppen des Ladevorgangs unterstützt.

energyStorageDistanceUnitForUX String

(Standard: "KILOMETERS")

Wird als Antwort an den Nutzer verwendet.

Unterstützte Werte:

KILOMETERS
MILES
isRechargeable Boolesch

(Standard: false)

Geben Sie „true“ an, wenn dieses Gerät wiederaufladbar ist. Dadurch kann das Gerät den Status capacityUntilFull, isCharging und optional isPluggedIn melden und den Befehl Charge akzeptieren.

Beispiele

Aufladbares Gerät

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

Aufladbares Gerät, das den aktuellen Ladezustand in Kilometern anzeigt

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

Nicht wiederaufladbares Gerät, das nur den aktuellen Ladezustand meldet

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

Gerät STATES

Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY-Vorgangs 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ätslevels. Dies gilt, wenn keine numerischen Kapazitätsdaten verfügbar sind. Wenn auch Daten zur numerischen Kapazität 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 aus Einheit/Wert-Paaren, die Informationen zur aktuellen Energiekapazität des Geräts enthalten. Beispiele: Wie viele Kilometer hat mein <device> aktuell? oder Wie viel Prozent Ladung hat mein <device> noch?

[item, ...] Objekt

Verbleibende Kapazität im Paar aus Einheit und Wert.

rawValue Ganzzahl

Erforderlich.

Der Kapazitätswert.

unit String

Erforderlich.

Die Kapazitätseinheit.

Unterstützte Werte:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

Array aus Einheit/Wert-Paaren, die Informationen zur Kapazität enthalten, bis das Gerät vollständig geladen ist. Beispiel: Wie lange es noch dauert, 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 derzeit angeschlossen ist. Das Gerät kann an eine Stromquelle angeschlossen sein, wird aber nicht aktiv geladen.

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 Ladezustand 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 Ladezustands unterstützt

{
  "descriptiveCapacityRemaining": "LOW"
}

BEFEHLUNGEN auf dem Gerät

Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE-Vorgangs 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.

„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ät ERRORS

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.

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