Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Informationen über Smart-Home-Aktionen. Hinweis:Die Aktionen in der Actions Console werden weiterhin erstellt.

Diese Seite wurde von der Cloud Translation API übersetzt.

Switch to English

Schema für Smart-Home-OpenClose-Trait

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

Geräte-ATTRIBUTE

Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC-Vorgangs. Weitere Informationen zum Umgang mit 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 die das Gerät geöffnet oder geschlossen werden kann. Verwenden Sie dieses Attribut, 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 unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft 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 offenen Zustand melden können, sollte dieses Feld auf „true“ gesetzt werden.

Beispiele

Einfaches Öffnen-/Schließen-Gerät

{
  "discreteOnlyOpenClose": true
}

Top-down-Gerät von unten nach oben. 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 Trait können die folgenden Status im Rahmen des QUERY-Vorgangs melden. Weitere Informationen zum Umgang mit 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

Bundesstaaten	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 für geschlossen und 100 vollständig geöffnet ist.

openPercent

Number

Erforderlich.

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

Öffnen/Schließen in mehrere Richtungen

Bundesstaaten	Typ	Beschreibung
`openState`	Array	Erforderlich. Liste der Zustände für jede unterstützte offene Richtung.
`[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 für geschlossen und 100 vollständig geöffnet ist.
`openDirection`	String	Erforderlich. Richtung, in die das Gerät geöffnet wird. Unterstützte Werte: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Beispiele

Einfaches Öffnen-/Schließen-Gerät

{
  "openPercent": 100
}

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

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

BEFEHLUNGEN auf dem Gerät

Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Auftragsausführung.

`action.devices.commands.OpenClose`

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

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 für geschlossen und 100 vollständig geöffnet ist.
`openDirection`	String	Richtung, in die geöffnet werden soll. Ist 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 Folgeantwort.

openPercent

Number

Erforderlich.

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

openDirection

String

Richtung, in die geöffnet werden soll. Ist 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 Folgeantwort.

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 Festlegen des Öffnungs-/Schließstatus des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

lockedState
deviceJammingDetected

Folgeantworten

Geräte mit dieser Eigenschaft können als Teil des EXECUTE-Vorgangs die folgende Nutzlast der Folgeantwort 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

Felder	Typ	Beschreibung
`followUpToken`	String	Erforderlich. Token, das in der ursprünglichen EXECUTE-Anfrage angegeben 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 geschlossen und 100 vollständig geöffnet ist.

followUpToken

String

Erforderlich.

Token, das in der ursprünglichen EXECUTE-Anfrage angegeben 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 geschlossen und 100 vollständig geöffnet ist.

Fehler

Felder Typ Beschreibung

Felder	Typ	Beschreibung
`followUpToken`	String	Erforderlich. Token, das in der ursprünglichen EXECUTE-Anfrage angegeben wurde.
`status`	String	Erforderlich. Ergebnis der Anfrage. Unterstützte Werte: `FAILURE`
`errorCode`	String	Erforderlich. Der Wert kann ein beliebiger Fehlercode für diese Eigenschaft sein, z. B. `lockedState`.

followUpToken

String

Erforderlich.

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

status

String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

FAILURE

errorCode

String

Erforderlich.

Der Wert kann ein beliebiger Fehlercode für diese Eigenschaft 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`

Passen Sie den Öffnungs-/Schließstatus des Geräts in Bezug auf den aktuellen Status an. Dieser Befehl ist nur verfügbar, wenn commandOnlyOpenClose auf false gesetzt ist.

Für diesen Befehl sind die folgenden Attribute erforderlich:

{
  "commandOnlyOpenClose": false
}

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openRelativePercent`	Number	Erforderlich. Der genaue Prozentsatz für die Änderung des Öffnungs-/Schließstatus. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt, z. B. „Die Jalousien etwas mehr öffnen“ oder „Die Jalousien um 5 % öffnen“.
`openDirection`	String	Richtung, in die geöffnet werden soll. Ist 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`

openRelativePercent

Number

Erforderlich.

Der genaue Prozentsatz für die Änderung des Öffnungs-/Schließstatus. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt, z. B. „Die Jalousien etwas mehr öffnen“ oder „Die Jalousien um 5 % öffnen“.

openDirection

String

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Öffne das Gerät etwas mehr.

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

Schließe das Gerät noch 10%

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

Öffnen Sie das Gerät um 50% nach unten.

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

Beim Festlegen des Öffnungs-/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ät ERRORS

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

Schema für Smart-Home-OpenClose-Trait

Geräte-ATTRIBUTE

Beispiele

Gerät STATES

Öffnen/Schließen in eine Richtung

Öffnen/Schließen in mehrere Richtungen

Beispiele

BEFEHLUNGEN auf dem Gerät

action.devices.commands.OpenClose

Parameter

Beispiele

Ähnliche Fehler

Folgeantworten

Abgeschlossen

Fehler

Beispiele

action.devices.commands.OpenCloseRelative

Parameter

Beispiele

Ähnliche Fehler

Beispieläußerungen

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

Gerät ERRORS

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`