Leitfaden für Smart-Home-Jalousien
action.devices.types.BLINDS – Jalousien können geöffnet und geschlossen werden. Außerdem werden verschiedene Jalousien unterstützt, wie Venezianisch (in eine Richtung öffnen), Bedienfeld oder vertikal (entweder nach links oder rechts geöffnet) und Draufsicht (von oben nach unten oder oben). Einige Jalousien haben möglicherweise Lamellen, die gedreht werden können.
Dieser Typ gibt an, dass das Gerät das Symbol „Jalousien“ 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 2.500 ms sein.
- Zuverlässigkeit:muss größer oder gleich 97% sein
Beispielgerät: Einfache Jalousien
Dieser Abschnitt enthält Beispiel-Nutzlasten, die je nach Gerätetyp und Eigenschaften oben eine gemeinsame „Jalousie“ darstellen. Wenn du bei der Implementierung Eigenschaften hinzufügst oder entfernst, ändere deine Antworten entsprechend.
In einer Jalousie von oben nach oben zeigt die UP-Richtung den unteren Teil der Jalousie und die Richtung DOWN den unteren Teil der Jalousie. Abbildung 1 zeigt ein Beispiel einer von oben nach unten stehenden Jalousie, wobei die UP-Richtung den unteren Teil der Jalousie um 50 % erhöht und die DOWN-Richtung den oberen Teil der Jalousie um 30 % verringert.
SYNC-Beispielantwort
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.BLINDS",
"traits": [
"action.devices.traits.OpenClose"
],
"name": {
"name": "Simple blinds"
},
"willReportState": true,
"attributes": {
"openDirection": [
"UP",
"DOWN"
]
},
"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,
"openState": [
{
"openPercent": 30,
"openDirection": "DOWN"
},
{
"openPercent": 50,
"openDirection": "UP"
}
]
}
}
}
}
Beispiele für EXECUTE-Befehle
Öffnen/Schließen
Weitere Informationen zu den Befehlsparametern finden Sie in der
Referenz zu action.devices.traits.OpenClose.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OpenClose",
"params": {
"openPercent": 10,
"openDirection": "DOWN"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"openState": [
{
"openPercent": 10,
"openDirection": "DOWN"
},
{
"openPercent": 50,
"openDirection": "UP"
}
]
}
}
]
}
}