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 |
energyStorageDistanceUnitForUX |
String |
(Standard: Wird als Antwort auf den Nutzer verwendet. Unterstützte Werte:
|
isRechargeable |
Boolesch |
(Standard: Setze den Wert auf „true“, wenn das Gerät wiederaufladbar ist. Das bedeutet, dass das Gerät möglicherweise den Status |
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:
|
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:
|
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:
|
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 AusnahmendeviceUnplugged
: Der Nutzer hat versucht, ein Gerät zu laden, das nicht an die Stromversorgung angeschlossen ist.