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 |
energyStorageDistanceUnitForUX |
String |
(Standard: Wird als Antwort an den Nutzer verwendet. Unterstützte Werte:
|
isRechargeable |
Boolesch |
(Standard: Geben Sie „true“ an, wenn dieses Gerät wiederaufladbar ist. Dadurch kann das Gerät den Status |
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:
|
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:
|
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:
|
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.