Kochanleitung für Smart-Home-Geräte
action.devices.types.COOKTOP – Zu den Interaktionen mit Kochfeldern gehören das Ein- und Ausschalten, das Starten und Stoppen eines Timers, das Einstellen eines Timers, das Anpassen der Kochmodi und der Voreinstellung für Lebensmittel sowie die Anpassung verschiedener Einstellungen für den Kochmodus.
Dieser Typ zeigt an, dass das Gerät das Cooktop-Symbol 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.
Empfohlene Eigenschaften
Diese Eigenschaften werden empfohlen, sofern sie für Ihr Gerät relevant sind. Sie können jedoch alle verfügbaren Merkmale beliebig kombinieren, um Ihre bestehenden Produktfunktionen bestmöglich anzupassen.
Qualitätsanforderungen
- Latenz:muss kleiner oder gleich 800 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein
Beispielgerät: Einfaches Kochfeld
Dieser Abschnitt enthält Beispiel-Nutzlasten, die auf einem gemeinsamen Gerätetyp und den oben genannten Merkmalen eine gemeinsame „Cooktop“ 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.COOKTOP",
"traits": [
"action.devices.traits.Cook",
"action.devices.traits.StartStop",
"action.devices.traits.Timer",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple cooktop"
},
"willReportState": true,
"attributes": {
"supportedCookingModes": [
"COOK",
"BOIL",
"SAUTE"
],
"foodPresets": [
{
"food_preset_name": "chicken_key",
"supported_units": [
"POUNDS",
"OUNCES"
],
"food_synonyms": [
{
"synonym": [
"Chicken",
"Chicken breast",
"Chicken thigh"
],
"lang": "en"
}
]
},
{
"food_preset_name": "bacon_key",
"supported_units": [
"POUNDS",
"OUNCES"
],
"food_synonyms": [
{
"synonym": [
"Bacon",
"Bacon strips"
],
"lang": "en"
}
]
}
],
"maxTimerLimitSec": 1200,
"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,
"timerRemainingSec": 120,
"currentCookingMode": "COOK",
"currentFoodPreset": "chicken_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": "BOIL"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentCookingMode": "BOIL",
"currentFoodPreset": "NONE"
}
}
]
}
}
Startstopp
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": 300
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"timerRemainingSec": 300
}
}
]
}
}
TimerEinstellen
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": 110
}
}
]
}
}
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": 120,
"timerPaused": true
}
}
]
}
}
Timer fortsetzen
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": 120,
"timerPaused": false
}
}
]
}
}
Timer abbrechen
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
}
}
]
}
}
An
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
}
}
]
}
}