OpenClose-Trait-Schema für Smart Home

action.devices.traits.OpenClose: Diese Eigenschaft gehört zu Geräten, die das Öffnen und Schließen sowie in einigen Fällen das Öffnen und Schließen teilweise oder möglicherweise auch in mehrere Richtungen unterstützen.

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des Vorgangs SYNC. Weitere Informationen zur Verarbeitung von SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
discreteOnlyOpenClose Boolesch

(Standard: false)

Ist die Richtlinie auf „true“ gesetzt, bedeutet dies, dass das Gerät entweder vollständig geöffnet oder vollständig geschlossen sein muss. Es werden also keine Werte zwischen 0% und 100 % unterstützt.

openDirection Array

Liste der unterstützten Richtungen, in denen das Gerät geöffnet oder geschlossen werden kann. Geben Sie dieses Attribut an, wenn das Gerät das Öffnen und Schließen in mehrere Richtungen unterstützt.

[item, ...] String

Unterstützte Richtung.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT
commandOnlyOpenClose Boolesch

(Standard: false)

Gibt an, ob das Gerät die bidirektionale (richtig) oder bidirektionale (falsch) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für dieses Merkmal nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann.

queryOnlyOpenClose Boolesch

(Standard: false)

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

Beispiele

Einfaches Öffnen und Schließen

{
  "discreteOnlyOpenClose": true
}

Top-down-Bottom-up-Gerät. Sie können in beide Richtungen geöffnet werden.

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

Gerät nur mit Sprachbefehlen

{
  "commandOnlyOpenClose": false
}

Gerät STATES

Entitäten mit diesem Merkmal können die folgenden Status als Teil des Vorgangs QUERY melden. Weitere Informationen zur Verarbeitung von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Die Nutzlast enthält eines der folgenden Elemente:

Öffnen/Schließen in eine Richtung

Bundesstaaten Typ Beschreibung
openPercent Number

Erforderlich.

Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 geschlossen und 100 vollständig geöffnet ist.

targetOpenPercent Number

Stufe, die den Prozentsatz angibt, zu dem das Gerät aufgrund einer laufenden Positionsänderung geöffnet wird bzw. in das es bewegt wird.

Öffnen/Schließen in mehrere Richtungen

Bundesstaaten Typ Beschreibung
openState Array

Erforderlich.

Liste der Status für jede unterstützte Öffnungsrichtung.

[item, ...] Objekt

Aktueller Status für die angegebene Öffnungsrichtung.

openPercent Number

Erforderlich.

Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 geschlossen und 100 vollständig geöffnet ist.

targetOpenPercent Number

Stufe, die den Prozentsatz angibt, zu dem das Gerät aufgrund einer laufenden Positionsänderung geöffnet wird bzw. in das es bewegt wird.

openDirection String

Erforderlich.

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

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Einfaches Öffnen und Schließen

{
  "openPercent": 100
}

Einfaches Öffnen/Schließen. Das Gerät öffnet sich derzeit in einer neuen Position.

{
  "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 wird um 30% nach unten und um 50% nach oben geöffnet; derzeit bewegt sich das Gerät um 80% nach oben.

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

BEFEHLE auf Gerät

Geräte mit diesem Trait können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zur Verarbeitung von EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

action.devices.commands.OpenClose

Legt den Öffnungs-/Schließzustand des Geräts fest.

Parameters

Parameters Typ Beschreibung
openPercent Number

Erforderlich.

Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 geschlossen und 100 vollständig geöffnet ist.

openDirection String

Richtung, in die geöffnet werden soll. Ist nur vorhanden, wenn das Gerät gemäß dem Attribut openDirection mehrere Richtungen unterstützt und eine Richtung vom Nutzer angegeben wurde.

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 um 50 % nach unten.

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

Beim Einrichten des Öffnungs-/Schließstatus ist ein Fehler aufgetreten.

Unterstützte Werte:

lockedState
deviceJammingDetected

Folgeantworten

Geräte mit dieser Eigenschaft können die folgende Nutzlast der Folgeantwort als Teil des Vorgangs EXECUTE zurückgeben. Weitere Informationen zum Implementieren von Folgeantworten findest du unter Benachrichtigungen für Smart-Home-Aktionen.

Die Nutzlast enthält eines der folgenden Elemente:

Abgeschlossen

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Token, das in der ursprünglichen EXECUTE-Anfrage bereitgestellt wurde.

status String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

SUCCESS
openPercent Number

Erforderlich.

Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 zu 100 geschlossen und 100 vollständig geöffnet ist.

Fehler

Felder Typ Beschreibung
followUpToken String

Erforderlich.

Token, das in der ursprünglichen EXECUTE-Anfrage bereitgestellt wurde.

status String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

FAILURE
errorCode String

Erforderlich.

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

Beispiele

Öffne das Garagentor. (Folgeantwort bei Erfolgsfall)

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

Öffne das Garagentor. (Folgeantwort bei Fehlerfall)

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

action.devices.commands.OpenCloseRelative

Stellt den Öffnungs-/Schließstatus des Geräts relativ zum aktuellen Zustand ein. Dieser Befehl ist nur verfügbar, wenn commandOnlyOpenClose auf false gesetzt ist.

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

Parameters

Parameters Typ Beschreibung
openRelativePercent Number

Erforderlich.

Der genaue Prozentsatz für die Änderung des Öffnungs-/Schließzustands. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt (z. B. „Lass die Jalousien etwas weiter öffnen“ oder „Öffne die Jalousien um 5 %“).

openDirection String

Richtung, in die geöffnet werden soll. Ist nur vorhanden, wenn das Gerät gemäß dem Attribut openDirection mehrere Richtungen unterstützt und eine Richtung vom Nutzer angegeben wurde.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Öffne das Gerät ein wenig mehr.

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

Gerät um 10% schließen

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

Auf dem Gerät 50% mehr nach unten öffnen

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

Beim Einrichten des Öffnungs-/Schließstatus 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

Sehen Sie sich die vollständige Liste der Fehler und Ausnahmen an.