Leitfaden für Smart-Home-Standmixer
action.devices.types.BLENDER
: Interaktionen mit Mixern können das Starten und Anhalten, das Einstellen eines Timers, das Festlegen von Kochmodi oder Lebensmittelvoreinstellungen oder das Anpassen anderer Einstellungen sein.
Das bedeutet, dass das Mixer-Symbol und einige zugehörige Synonyme und Aliasse auf dem Gerät angezeigt werden.
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 800 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein.
Beispielgerät: einfacher Mixer
Dieser Abschnitt enthält Beispiel-Intent-Nutzlasten, die auf der Grundlage des oben genannten Gerätetyps und der oben genannten Merkmale einen gemeinsamen „Blender“ 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.BLENDER", "traits": [ "action.devices.traits.Cook", "action.devices.traits.StartStop", "action.devices.traits.Timer", "action.devices.traits.OnOff" ], "name": { "name": "Simple blender" }, "willReportState": true, "attributes": { "supportedCookingModes": [ "BLEND", "PUREE", "WHIP" ], "foodPresets": [ { "food_preset_name": "smoothie_key", "supported_units": [ "CUPS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Smoothie", "Shake" ], "lang": "en" } ] }, { "food_preset_name": "salad_dressing_key", "supported_units": [ "CUPS", "OUNCES" ], "food_synonyms": [ { "synonym": [ "Salad dressing", "Dressing" ], "lang": "en" } ] } ], "maxTimerLimitSec": 30, "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, "timerRemainingSec": 15, "currentCookingMode": "BLEND", "currentFoodPreset": "smoothie_key" } } } }
Beispiele für EXECUTE-Befehle
Kochen
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.Cook
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "WHIP" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentCookingMode": "WHIP", "currentFoodPreset": "NONE" } } ] } }
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 } } ] } }
TimerStart
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.Timer
.
{ "requestId": "6894439706274654522", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 30 } } ] } ] } } ] }
{ "requestId": "6894439706274654522", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 30 } } ] } }
TimerAdjust
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.Timer
.
{ "requestId": "6894439706274654524", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerAdjust", "params": { "timerTimeSec": -10 } } ] } ] } } ] }
{ "requestId": "6894439706274654524", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 20 } } ] } }
TimerPause
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.Timer
.
{ "requestId": "6894439706274654526", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerPause" } ] } ] } } ] }
{ "requestId": "6894439706274654526", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 15, "timerPaused": true } } ] } }
TimerResume
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.Timer
.
{ "requestId": "6894439706274654528", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerResume" } ] } ] } } ] }
{ "requestId": "6894439706274654528", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": 15, "timerPaused": false } } ] } }
TimerCancel
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.Timer
.
{ "requestId": "6894439706274654530", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.TimerCancel" } ] } ] } } ] }
{ "requestId": "6894439706274654530", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "timerRemainingSec": -1 } } ] } }
OnOff
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654532", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654532", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }