Smart Home OpenClose-Trait-Schema

action.devices.traits.OpenClose: Dieses Merkmal gehört zu Geräten, die das Öffnen und Schließen unterstützen, in einigen Fällen auch das teilweise Öffnen und Schließen oder das Öffnen und Schließen in mehr als einer Richtung.

Geräteattribute

Geräte mit diesem Merkmal können die folgenden Attribute im Rahmen des Vorgangs SYNC melden. Weitere Informationen zur Verarbeitung von SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute Typ Beschreibung
discreteOnlyOpenClose Boolesch

(Standardeinstellung: false)

Wenn der Wert auf „true“ gesetzt ist, muss das Gerät entweder vollständig geöffnet oder vollständig geschlossen sein. Werte zwischen 0% und 100 % werden nicht unterstützt.
openDirection Array

Liste der unterstützten Richtungen, in denen das Gerät geöffnet oder geschlossen werden kann. Fügen Sie dieses Attribut hinzu, wenn das Gerät das Öffnen und Schließen in mehr als einer Richtung unterstützt.
[item, ...] String

Unterstützte Richtung.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Boolesch

(Standardeinstellung: false)

Gibt an, ob das Gerät die Einwegkommunikation (true) oder die Zweiwegkommunikation (false) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder einen Report State für dieses Merkmal reagieren kann.
queryOnlyOpenClose Boolesch

(Standardeinstellung: false)

Gibt an, ob für das Gerät nur Statusinformationen abgefragt werden können und es nicht gesteuert werden kann. Bei Sensoren, die nur den offenen Status melden können, sollte dieses Feld auf „true“ gesetzt werden.

Beispiele

Einfaches Gerät zum Öffnen und Schließen

{
  "discreteOnlyOpenClose": true
}

Top-down- und Bottom-up-Gerät. Kann in beide Richtungen geöffnet werden.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

Gerät, das nur Befehle ausführt.

{
  "commandOnlyOpenClose": false
}

Gerätestatus

Für Entitäten mit diesem Merkmal können im Rahmen des Vorgangs QUERY die folgenden Status gemeldet werden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Fulfillment.

Die Nutzlast enthält eines der folgenden Elemente:

Öffnen und Schließen in eine Richtung

Bundesstaaten Typ Beschreibung
openPercent Number

Erforderlich.

Gibt den Prozentsatz an, um den ein Gerät geöffnet ist. 0 % bedeutet, dass es geschlossen ist, 100 %, dass es vollständig geöffnet ist.

Wert muss zwischen 0 und 100 liegen
targetOpenPercent Number

Der Wert gibt an, wie weit das Gerät geöffnet wird oder sich gerade öffnet.

Wert muss zwischen 0 und 100 liegen

Öffnen und Schließen in mehreren Richtungen

Bundesstaaten Typ Beschreibung
openState Array

Erforderlich.

Liste der Status für jede unterstützte offene Richtung.
[item, ...] Objekt

Aktueller Status für die angegebene Öffnungsrichtung.
openPercent Number

Erforderlich.

Gibt den Prozentsatz an, um den ein Gerät geöffnet ist. 0 % bedeutet, dass es geschlossen ist, 100 %, dass es vollständig geöffnet ist.

Wert muss zwischen 0 und 100 liegen
targetOpenPercent Number

Der Wert gibt an, wie weit das Gerät geöffnet wird oder sich gerade öffnet.

Wert muss zwischen 0 und 100 liegen
openDirection String

Erforderlich.

Richtung, in der das Gerät geöffnet wird.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Einfaches Gerät zum Öffnen und Schließen

{
  "openPercent": 100
}

Einfaches Gerät zum Öffnen und Schließen wird gerade in eine neue Position gebracht.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

Öffne das Gerät um 30% nach unten und um 50% nach oben.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

Gerät um 30% nach unten und um 50% nach oben öffnen. Das Gerät wird gerade um 80% nach oben geöffnet.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

GERÄTEBEFEHLE

Geräte mit diesem Merkmal reagieren möglicherweise auf die folgenden Befehle im Rahmen des Vorgangs EXECUTE. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.OpenClose

Legen Sie den Öffnungs-/Schließstatus des Geräts fest.

Parameter

Parameter Typ Beschreibung
openPercent Number

Erforderlich.

Gibt den Prozentsatz an, um den ein Gerät geöffnet ist. 0 % bedeutet, dass es geschlossen ist, 100 %, dass es vollständig geöffnet ist.

Wert muss zwischen 0 und 100 liegen
openDirection String

Richtung, in die sich das Gerät öffnen soll. Nur vorhanden, wenn das Gerät mehrere Richtungen unterstützt, wie durch das Attribut openDirection angegeben, und eine Richtung vom Nutzer angegeben wird.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Von Google bereitgestelltes Token für die Follow-up-Antwort.

Beispiele

Öffne das Gerät.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

Öffne das Gerät zu 50 %.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

Beim Festlegen des Öffnungs- und Schließstatus des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

lockedState
deviceJammingDetected

Folgeantworten

Geräte mit diesem Merkmal können die folgende Nutzlast für die Folgeantwort als Teil des EXECUTE-Vorgangs zurückgeben. Weitere Informationen zum Implementieren von Folgeantworten finden Sie unter Benachrichtigungen für Smart-Home-Aktionen.

Die Nutzlast enthält eines der folgenden Elemente:

Erfolg

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Das in der ursprünglichen EXECUTE-Anfrage bereitgestellte Token.
status String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

SUCCESS
openPercent Number

Erforderlich.

Gibt den Prozentsatz an, um den ein Gerät geöffnet ist. 0 % bedeutet, dass es geschlossen ist, 100 %, dass es vollständig geöffnet ist.

Wert muss zwischen 0 und 100 liegen

Fehler

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Das in der ursprünglichen EXECUTE-Anfrage bereitgestellte Token.
status String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

FAILURE
errorCode String

Erforderlich.

Der Wert kann ein beliebiger Fehlercode für dieses Attribut sein, z. B. lockedState.

Beispiele

Öffne das Garagentor. (Folgeantwort für Erfolgsfall)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

Öffne das Garagentor. (Folgeantwort für den Fehlerfall)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

action.devices.commands.OpenCloseRelative

Hiermit wird der Öffnungs- oder Schließzustand des Geräts relativ zum aktuellen Zustand angepasst. Dieser Befehl ist nur verfügbar, wenn discreteOnlyOpenClose auf false festgelegt ist.

Für diesen Befehl sind die folgenden Attribute erforderlich: 
{
  "discreteOnlyOpenClose": false
}

Parameter

Parameter Typ Beschreibung
openRelativePercent Number

Erforderlich.

Der genaue Prozentsatz, um den Öffnungs-/Schließstatus zu ändern. Mehrdeutige relative Befehle werden in einen genauen Prozentparameter umgewandelt (z. B. „Öffne die Jalousien etwas weiter“ im Vergleich zu „Öffne die Jalousien um 5 %“).

Wert muss zwischen -100 und 100 liegen
openDirection String

Richtung, in die sich das Gerät öffnen soll. Nur vorhanden, wenn das Gerät mehrere Richtungen unterstützt, wie durch das Attribut openDirection angegeben, und eine Richtung vom Nutzer angegeben wird.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Gerät etwas weiter öffnen

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

Schließe das Gerät noch 10% weiter.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

Öffne das Gerät um 50% nach unten.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

Beim Festlegen des Öffnungs- und Schließstatus des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

lockedState
deviceJammingDetected

Beispieläußerungen

de-DE

  • Bitte öffne die Jalousien auf 30%
  • Fensterläden um 25 % schliessen
  • Ist die Jalousie zu?
  • Mach den Rollladen zu
  • Mach die Rollos auf
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • Are the blinds in the kitchen open
  • Close the blinds 25% in my room
  • Close the door more
  • Just close the front door
  • open the blinds in my room
  • open the blinds to 25%
  • open the door by 25%

es-ES

  • abre la ventana del salón
  • cerrar persianas del dormitorio un 20%
  • cierra la cortina del salón
  • cierra mucho más la ventana
  • está abierta la puerta
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • est-ce que la porte d'entrée est ouverte
  • ferme les stores
  • ferme un peu les stores
  • ouvre les stores
  • ouvre les stores de la chambre de 25%
  • ouvre les stores à 25%

hi-IN

  • कृपया 25% पर्दे को खुला रखो
  • क्या मैंने सामने वाला दरवाजा खुला छोड दिया?
  • पर्दे को 25% बंद करोगे
  • पर्दे खोलो
  • ब्लाइंड 25% खुले पर सेट कर दीजिए
  • ब्लाइंड को थोड़ा और बंद कर दिजिए
  • ब्लाइंड बंद करें

it-IT

  • abbassa un po' di più le tapparelle
  • apri la serranda
  • apri la tapparella al 30%
  • apri le serrande del 30%
  • chiudi le serrande
  • chiudi le tende del 25%
  • è aperta la porta d'ingresso

ja-JP

  • 25% に ブラインド を開けて
  • 25% ブラインド を閉めてください
  • 25% ブラインド 開けて
  • ブラインド 閉めて
  • ブラインド 開けて
  • 少し ブラインド を閉じて
  • 玄関のドア は開いてますか

ko-KR

  • 문 살짝만 닫아 줘
  • 블라인드 25% 열어 줘
  • 블라인드 25% 까지 열어 줘
  • 블라인드 30프로 닫아
  • 블라인드 닫아 줘
  • 블라인드 열어 줘
  • 안방 문 열렸어

nl-NL

  • doe de gordijnen 25% open
  • doe de jaloezieën voor 25% dicht
  • doe het raam ietsje meer dicht
  • is de voordeur open
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • As cortinas estão abertas?
  • Fecha a persiana toda
  • Fechar a janela 10%
  • a cortina do quarto está aberta?
  • abra a persiana até 30%
  • abre as cortinas
  • abre as cortinas a 50%
  • abrir as cortinas
  • abrir as cortinas na sala em 30%
  • fecha a persiana por favor
  • fecha um bocado a janela
  • fechar as cortinas em 25%
  • fechar um pouco mais as cortinas

sv-SE

  • Dra upp persiennerna
  • Dra upp persiennerna till 25%
  • stäng persiennen i mitt rum 25%
  • stäng persiennerna
  • är ytterdörren öppen?
  • öppna persiennerna med 25%

GERÄTEFEHLER

Vollständige Liste der Fehler und Ausnahmen