Smart-Home-Wasserkocher-Leitfaden
action.devices.types.KETTLE – Wasserkocher sind Geräte, die Wasser kochen. Zu den Interaktionen mit Wasserkochern gehören das Ein- und Ausschalten, die Anpassung der Zieltemperatur und möglicherweise verschiedene Einstellungen im Modus.
Dieser Typ gibt an, dass das Gerät das Kettle-Symbol und einige zugehörige Synonyme und Aliasse erhält.
Wasserkocher haben eine typbasierte Grammatik füraction.devices.traits.OnOff.
Wenn das Gerät OnOff unterstützt, wird mit Ein wenig Wasser ein action.devices.commands.OnOff-Befehl gesendet.
Gerätefunktionen
In der zugehörigen Dokumentation zur Dokumentation finden Sie Details zur Implementierung, z. B. Attribute und Status, die Ihr Dienst unterstützen sollte, und das Erstellen von EXECUTE- und QUERY-Antworten.
Erforderliche Merkmale
Diese Eigenschaften und Befehle sind, falls auf Ihrem Gerät zutreffend, erforderlich.
Empfohlene Merkmale
Diese Eigenschaften werden empfohlen, sofern dies auf Ihr Gerät zutrifft. Sie können jedoch alle verfügbaren Merkmale beliebig kombinieren, um sie optimal an Ihre vorhandene Produktfunktion anzupassen.
Qualitätsanforderungen
- Latenz muss kleiner oder gleich 800 ms sein.
- Zuverlässigkeit muss mindestens 97 % betragen.
Beispielgerät: Wasserkocher
Dieser Abschnitt enthält beispielhafte Nutzlasten von Intents, die je nach Gerätetyp und Merkmalen einen gemeinsamen „Kettle“ darstellen. Wenn Sie in Ihrer Implementierung Merkmale hinzufügen oder entfernen, passen Sie Ihre Antworten entsprechend an.
SYNC-Beispielantwort
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.KETTLE",
"traits": [
"action.devices.traits.TemperatureControl",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple kettle"
},
"willReportState": true,
"attributes": {
"temperatureRange": {
"minThresholdCelsius": 0,
"maxThresholdCelsius": 100
},
"temperatureUnitForUX": "F"
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
QUERY-Beispielantwort
{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"on": true,
"temperatureSetpointCelsius": 100
}
}
}
}
Beispiele für EXECUTE-Befehle
Temperatur einstellen
Weitere Informationen zu den Befehlsparametern finden Sie in der Referenz zu action.devices.traits.TemperatureControl.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetTemperature",
"params": {
"temperature": 85
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"temperatureSetpointCelsius": 85
}
}
]
}
}
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
}
}
]
}
}