Smart-Home-Jalousien – Leitfaden

action.devices.types.BLINDS – Jalousien können geöffnet und geschlossen werden. Es werden verschiedene Jalousientypen unterstützt, z. B. Lamellenjalousien (öffnen sich in eine Richtung), Lamellenvorhänge oder vertikale Jalousien (können sich nach links oder rechts öffnen) und Jalousien, die von oben nach unten oder von unten nach oben geöffnet werden (können sich nach oben oder unten öffnen). Einige Jalousien haben Lamellen, die gedreht werden können.

Dieser Typ gibt an, dass das Gerät das Jalousiensymbol und einige zugehörige Synonyme und Aliasse erhält.

Gerätefunktionen

In der entsprechenden Dokumentation zu Merkmalen finden Sie Implementierungsdetails wie Attribute und Status, die Ihr Dienst unterstützen sollte, sowie Informationen zum Erstellen von EXECUTE- und QUERY-Antworten.

Erforderliche Merkmale

Diese Merkmale und Befehle sind erforderlich, sofern sie für Ihr Gerät gelten. 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.

Diese Eigenschaften werden empfohlen, sofern sie für Ihr Gerät gelten. Sie können jedoch alle verfügbaren Merkmale kombinieren, um sie bestmöglich an Ihre vorhandenen Produktfunktionen anzupassen.

Qualitätsanforderungen

  • Latenz:muss kleiner als oder gleich 2.500 ms sein.
  • Zuverlässigkeit:muss mindestens 97% betragen.

Beispielgerät: Jalousien

Dieser Abschnitt enthält Beispielnutzlasten für Intents, die auf dem Gerätetyp und den oben genannten Merkmalen basieren und für eine gängige Jalousie verwendet werden. Wenn Sie in Ihrer Implementierung Merkmale hinzufügen oder entfernen, ändern Sie Ihre Antworten entsprechend, um diese Änderungen widerzuspiegeln.

Bei einem von oben nach unten und von unten nach oben bedienbaren Fensterrollo wird der untere Teil des Rollos in Richtung UP angehoben und der obere Teil in Richtung DOWN abgesenkt. Abbildung 1 zeigt ein Beispiel für ein oben-unten-unten-oben-Jalousiensystem, bei dem der untere Teil der Jalousie in Richtung UP um 50 % angehoben und der obere Teil in Richtung DOWN um 30 % abgesenkt wird.

Abbildung 1 Top-down-Bottom-Up-Blind

Beispiel für eine SYNC-Antwort

Anfrage
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Antwort
{
  "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

Anfrage
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Antwort
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "openState": [
          {
            "openPercent": 30,
            "openDirection": "DOWN"
          },
          {
            "openPercent": 50,
            "openDirection": "UP"
          }
        ]
      }
    }
  }
}

Beispielbefehle für EXECUTE

OpenClose

Weitere Informationen zu den Befehlsparametern finden Sie in der action.devices.traits.OpenClose-Referenz.

Anfrage
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OpenClose",
                "params": {
                  "openPercent": 10,
                  "openDirection": "DOWN"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Antwort
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "openState": [
            {
              "openPercent": 10,
              "openDirection": "DOWN"
            },
            {
              "openPercent": 50,
              "openDirection": "UP"
            }
          ]
        }
      }
    ]
  }
}

GERÄTEFEHLER

Eine vollständige Liste der Fehler und Ausnahmen