Smart-Home-Ladegeräte-Leitfaden
action.devices.types.CHARGER
– Zu den Interaktionen mit Ladegeräten gehören das Starten und Stoppen des Ladevorgangs und das Prüfen des aktuellen Ladezustands, der verbleibenden Kapazität und der Kapazität, bis der vollständige Wert erreicht ist.
Dieser Typ zeigt an, dass das Gerät das Ladegerät und einige zugehörige Synonyme und Aliasse erhält.
Gerätefunktionen
In der zugehörigen Dokumentation zur Eigenschaft finden Sie Implementierungsdetails wie Attribute und Status, die Ihr Dienst unterstützen sollte, und zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Eigenschaften
Diese Eigenschaften und Befehle sind erforderlich, falls sie auf Ihr Gerät zutreffen. Wenn Ihr Gerät diese Eigenschaften nicht unterstützt, geben Sie den Fehlercode functionNotSupported
in einer QUERY- oder EXECUTE-Antwort ein. Weitere Informationen finden Sie unter Fehler und Ausnahmen.
Qualitätsanforderungen
- Latenz:muss kleiner oder gleich 800 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein
Beispielgerät: Einfaches Ladegerät
Dieser Abschnitt enthält Beispiel-Nutzlastdaten, die je nach Gerätetyp und Eigenschaften oben ein gemeinsames „Ladegerät“ darstellen. Wenn du bei der Implementierung Eigenschaften hinzufügst oder entfernst, ändere deine Antworten entsprechend.
SYNC-Beispielantwort
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CHARGER", "traits": [ "action.devices.traits.EnergyStorage" ], "name": { "name": "Simple charger" }, "willReportState": true, "attributes": { "isRechargeable": true, "queryOnlyEnergyStorage": false }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Beispiel für eine QUERY-Antwort
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "descriptiveCapacityRemaining": "MEDIUM", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "capacityUntilFull": [ { "unit": "SECONDS", "rawValue": 3600 } ], "isCharging": true } } } }
Beispiele für EXECUTE-Befehle
Kosten
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.EnergyStorage
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Charge", "params": { "charge": false } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 50 } ], "isCharging": false } } ] } }