Smart-Home-Geschirrspüleranleitung
action.devices.types.DISHWASHER
– Die Start- und Stoppfunktion von Geschirrspülern kann unabhängig vom Ein- und Ausschalten aktiviert werden. Einige Waschmaschinen haben eine separate Ein-/Aus-Taste, andere nicht. Einige können beim Waschen pausiert und fortgesetzt werden.
Auch Geschirrspüler haben verschiedene Modi und jeder Modus verfügt über eigene zugehörige Einstellungen. Diese beziehen sich speziell auf den Geschirrspüler und werden allgemein interpretiert.
Das bedeutet, dass das Gerät das Geschirrspülersymbol und einige zugehörige Synonyme und Aliasse erhält.
Gerätefunktionen
Details zur Implementierung finden Sie in der entsprechenden Dokumentation zu Trait. Dazu gehören z. B. Attribute und Statusangaben, die Ihr Dienst unterstützen sollte, und Informationen zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Merkmale
Diese Merkmale und Befehle sind gegebenenfalls für Ihr Gerät erforderlich. Wenn Ihr Gerät diese Merkmale nicht unterstützt, geben Sie den Fehlercode functionNotSupported
in einer QUERY- oder EXECUTE-Antwort ein. Weitere Informationen finden Sie unter Fehler und Ausnahmen.
Empfohlene Traits
Diese Traits werden empfohlen, sofern sie für Ihr Gerät relevant sind. Sie können jedoch alle verfügbaren Merkmale beliebig kombinieren, um die Funktionalität Ihrer vorhandenen Produkte bestmöglich zu berücksichtigen.
Qualitätsanforderungen
- Latenz:muss kleiner oder gleich 3.000 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein.
Beispielgerät: Einfache Spülmaschine
Dieser Abschnitt enthält Beispiel-Intent-Nutzlasten, die basierend auf dem oben genannten Gerätetyp und den oben genannten Merkmalen einen gemeinsamen Geschirrspüler darstellen. Wenn Sie in Ihrer Implementierung Traits hinzufügen oder entfernen, passen Sie Ihre Antworten entsprechend an.
Beispiel für SYNC-Antwort
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DISHWASHER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.RunCycle", "action.devices.traits.StartStop" ], "name": { "name": "Simple dishwasher" }, "willReportState": true, "attributes": { "pausable": true }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Beispielantwort für QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "on": true, "isRunning": true, "isPaused": false, "currentRunCycle": [ { "currentCycle": "sanitize", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 } } } }
Beispiele für EXECUTE-Befehle
OnOff
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }
StartStop
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.StartStop
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.StartStop", "params": { "start": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "isRunning": true, "isPaused": false } } ] } }