Ratgeber für Smart-Home-Jalousien

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

Dieser Typ gibt an, dass das Gerät das Symbol für Jalousien und einige zugehörige Synonyme und Aliase erhält.

Gerätefunktionen

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

Erforderliche Merkmale

Diese Attribute und Befehle sind erforderlich, sofern sie für dein Gerät gelten. Wenn dein Gerät diese Merkmale nicht unterstützt, gib den Fehlercode functionNotSupported in einer QUERY- oder EXECUTE-Antwort ein. Weitere Informationen finden Sie unter Fehler und Ausnahmen.

Diese Attribute werden empfohlen, sofern sie für Ihr Gerät zutreffen. Sie können jedoch alle verfügbaren Eigenschaften kombinieren, um die vorhandene Produktfunktionalität optimal abzubilden.

Beispielgerät: Einfache Jalousien

Dieser Abschnitt enthält Beispiel-Intent-Payloads für ein gemeinsames „Rollo“ basierend auf dem Gerätetyp und den oben genannten Eigenschaften. Wenn Sie Ihrer Implementierung Attribute hinzufügen oder daraus entfernen, müssen Sie Ihre Antworten entsprechend anpassen.

Bei einem Rollo, das von oben nach unten und von unten nach oben geöffnet werden kann, wird durch die Richtung UP der untere Teil des Rollos angehoben und durch die Richtung DOWN der obere Teil des Rollos abgesenkt. Abbildung 1 zeigt ein Beispiel für ein Rollo, das von oben nach unten und von unten nach oben geöffnet werden kann. In UP-Richtung wird der untere Teil des Rollos um 50 Prozent angehoben und in DOWN-Richtung wird der obere Teil des Rollos um 30 Prozent abgesenkt.

Abbildung 1: Top-down-Bottom-up-Jalousie

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 Referenz zu action.devices.traits.OpenClose.

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

Vollständige Liste der Fehler und Ausnahmen