Smart-Home-Ofenanleitung
action.devices.types.OVEN: Bei der Nutzung von Öfen ist es möglich, bei bestimmten Temperaturen zu backen oder zu kochen. Die tatsächliche Temperatur des Ofens unterscheidet sich je nach Ofen, daher kann der Ofen ebenfalls überwacht werden. Die Backzeit des Ofens ist begrenzt.
Dieser Typ zeigt an, dass das Gerät das Ofensymbol und einige zugehörige Synonyme und Aliasse erhält.
Öfen mit typbasierter Grammatik füraction.devices.traits.OnOff und action.devices.traits.TemperatureControl:
- Wenn das Gerät
OnOffunterstützt, sendet Heizen im Ofen einenaction.devices.commands.OnOff-Befehl. - Wenn das Gerät
TemperatureControlunterstützt, sendet Heizen auf den Ofen auf 350 Grad einen Befehl zum Einstellen des Ofens auf diese Temperatur.
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, sofern sie auf Ihrem Gerät verfügbar sind.
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 3.000 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein
Beispielgerät: Einfacher Ofen
Dieser Abschnitt enthält Beispielnutzlasten, die je nach Gerätetyp und Eigenschaften einen gemeinsamen „Ofen“ 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.OVEN",
"traits": [
"action.devices.traits.Cook",
"action.devices.traits.OnOff",
"action.devices.traits.TemperatureControl",
"action.devices.traits.Timer",
"action.devices.traits.StartStop"
],
"name": {
"name": "Simple oven"
},
"willReportState": true,
"attributes": {
"supportedCookingModes": [
"BAKE",
"CONVECTION_BAKE",
"ROAST"
],
"maxTimerLimitSec": 3600,
"temperatureRange": {
"minThresholdCelsius": 65,
"maxThresholdCelsius": 288
},
"temperatureUnitForUX": "F"
},
"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,
"temperatureSetpointCelsius": 175,
"currentCookingMode": "BAKE",
"timerRemainingSec": -1
}
}
}
}
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": "ROAST"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentCookingMode": "ROAST"
}
}
]
}
}
An
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.OnOff.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}
Temperatur einstellen
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.TemperatureControl.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetTemperature",
"params": {
"temperature": 200
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"temperatureSetpointCelsius": 200,
"temperatureAmbientCelsius": 100
}
}
]
}
}
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": 290
}
}
]
}
}
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": 300,
"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": 300,
"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
}
}
]
}
}
Startstopp
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.StartStop.
{
"requestId": "6894439706274654532",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.StartStop",
"params": {
"start": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654532",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"isRunning": true
}
}
]
}
}