Smart-Home-Geschirrspüler – Anleitung
action.devices.types.DISHWASHER
: Geschirrspüler können unabhängig vom Ein- oder Ausschalten gestartet und angehalten werden. Einige Geschirrspüler haben eine separate Ein-/Aus-Taste, andere nicht. Einige können während des Waschens pausiert und fortgesetzt werden.
Geschirrspüler haben auch verschiedene Modi und jeder Modus hat seine eigenen zugehörigen Einstellungen. Sie sind spezifisch für die Spülmaschine und werden in einer allgemeinen Form interpretiert.
Dieser Typ gibt an, dass das Gerät das Symbol „Geschirrspüler“ und einige zugehörige Synonyme und Aliasse erhält.
Gerätefunktionen
In der entsprechenden Dokumentation zu Merkmalen finden Sie Implementierungsdetails wie Attribute und Status, die Ihr Dienst unterstützen sollte, sowie Informationen zum Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Merkmale
Diese Merkmale und Befehle sind erforderlich, sofern sie für Ihr Gerät gelten. 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.
Empfohlene Merkmale
Diese Eigenschaften werden empfohlen, sofern sie für Ihr Gerät gelten. Sie können jedoch alle verfügbaren Merkmale kombinieren, um sie bestmöglich an Ihre vorhandenen Produktfunktionen anzupassen.
Qualitätsanforderungen
- Latenz:darf maximal 3.000 ms betragen.
- Zuverlässigkeit:muss mindestens 97% betragen.
Beispielgerät: Einfacher Geschirrspüler
Dieser Abschnitt enthält Beispiel-Intent-Nutzlasten für eine gängige „Spülmaschine“ basierend auf den oben genannten Gerätetypen und -merkmalen. Wenn Sie in Ihrer Implementierung Merkmale hinzufügen oder entfernen, ändern Sie Ihre Antworten entsprechend, um diese Änderungen widerzuspiegeln.
Beispiel für eine 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" } } ] } }
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, "on": true, "isRunning": true, "isPaused": false, "currentRunCycle": [ { "currentCycle": "sanitize", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 } } } }
Beispielbefehle für EXECUTE
OnOff
Weitere Informationen zu den Befehlsparametern finden Sie in der
action.devices.traits.OnOff
-Referenz.
{ "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
action.devices.traits.StartStop
-Referenz.
{ "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 } } ] } }