Anleitung für Smart-Home-Wasserhähne
action.devices.types.FAUCET: Über den Wasserhahn können Flüssigkeiten in verschiedenen Mengen und Voreinstellungen ausgegeben werden. Wasserhähne können verschiedene Modi haben und jeder Modus hat seine eigenen zugehörigen Einstellungen. Diese sind spezifisch für den Wasserhahn und werden in allgemeiner Form interpretiert.
Dieser Typ gibt an, dass das Gerät das Wasserhahn-Symbol und einige zugehörige Synonyme und Aliasse.
Gerätefunktionen
Weitere Informationen finden Sie in der entsprechenden Dokumentation Implementierungsdetails wie Attribute und Angaben, die Ihr Dienst unterstützen soll, und wie Sie EXECUTE- und QUERY-Antworten erstellen.
Empfohlene Eigenschaften
Diese Traits werden empfohlen, sofern sie für Ihr Gerät relevant sind. Du kannst jedoch alle verfügbaren Merkmale beliebig kombinieren, um deine vorhandenen Merkmale bestmöglich anzupassen. Produktfunktionen.
-
action.devices.traits.Dispense -
action.devices.traits.StartStop -
action.devices.traits.TemperatureControl
Qualitätsanforderungen
- Latenz:muss kleiner oder gleich 800 ms sein.
- Zuverlässigkeit:Muss größer oder gleich 97% sein.
Beispielgerät: Einfacher Wasserhahn
Dieser Abschnitt enthält Beispiele für Intent-Nutzlasten, die einen gemeinsamen "Wasserhahn" darstellen basierend auf dem Gerätetyp und den oben genannten Merkmalen. Wenn Sie in Ihrer Implementierung Tragen hinzufügen oder entfernen, und passen Sie Ihre Antworten entsprechend an.
Beispiel für SYNC-Antwort
<ph type="x-smartling-placeholder">{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.FAUCET",
"traits": [
"action.devices.traits.Dispense",
"action.devices.traits.TemperatureControl",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple faucet"
},
"willReportState": true,
"attributes": {
"supportedDispenseItems": [
{
"item_name": "water_key",
"item_name_synonyms": [
{
"lang": "en",
"synonyms": [
"Water"
]
},
{
"lang": "es",
"synonyms": [
"Agua"
]
},
{
"lang": "fr",
"synonyms": [
"Eau"
]
}
],
"supported_units": [
"TEASPOONS",
"TABLESPOONS",
"FLUID_OUNCES",
"CUPS",
"PINTS",
"QUARTS",
"GALLONS",
"MILLILITERS",
"LITERS",
"DECILITERS"
],
"default_portion": {
"amount": 2,
"unit": "CUPS"
}
}
],
"supportedDispensePresets": [
{
"preset_name": "cat_water_bowl_key",
"preset_name_synonyms": [
{
"lang": "en",
"synonyms": [
"Cat water bowl",
"Cat water dish",
"Cat water cup"
]
},
{
"lang": "es",
"synonyms": [
"Plato de agua para gato",
"Bebedero para gato"
]
},
{
"lang": "fr",
"synonyms": [
"Bol d'eau de chat",
"Bac \u00e0 eau pour chat",
"Tasse d'eau de chat"
]
}
]
}
],
"temperatureRange": {
"minThresholdCelsius": 25,
"maxThresholdCelsius": 100
},
"temperatureUnitForUX": "F"
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Beispiel für eine QUERY-Antwort
<ph type="x-smartling-placeholder">{
"requestId": "6894439706274654514",
"inputs": [
{
"intent": "action.devices.QUERY",
"payload": {
"devices": [
{
"id": "123"
}
]
}
}
]
}
{
"requestId": "6894439706274654514",
"payload": {
"devices": {
"123": {
"status": "SUCCESS",
"online": true,
"on": false,
"temperatureSetpointCelsius": 30,
"dispenseItems": [
{
"itemName": "water_key",
"amountLastDispensed": {
"amount": 2.5,
"unit": "CUPS"
},
"isCurrentlyDispensing": false
}
]
}
}
}
}
Beispiele für EXECUTE-Befehle
Ausgabe
Weitere Informationen zu den Befehlsparametern
Siehe
action.devices.traits.Dispense.
Referenz.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.Dispense",
"params": {
"amount": 1,
"unit": "CUPS",
"item": "water_key"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"dispenseItems": [
{
"itemName": "water_key",
"amountLastDispensed": {
"amount": 1,
"unit": "CUPS"
},
"isCurrentlyDispensing": true
}
]
}
}
]
}
}
SetTemperature
Weitere Informationen zu den Befehlsparametern
Siehe
action.devices.traits.TemperatureControl.
Referenz.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetTemperature",
"params": {
"temperature": 65
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"temperatureSetpointCelsius": 65
}
}
]
}
}
OnOff
Weitere Informationen zu den Befehlsparametern
Siehe
action.devices.traits.OnOff.
Referenz.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}