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.

Schema für Smart-Home-Open-Close-Trait

action.devices.traits.OpenClose: Dieser Trait gehört zu Geräten, die das Öffnen und Schließen unterstützen. In einigen Fällen kann dieses auch teilweise oder möglicherweise in mehrere Richtungen geöffnet und geschlossen werden.

Geräte-ATTRIBUTES

Auf Geräten mit diesem Trait kann Folgendes gemeldet werden im Rahmen des SYNC-Vorgangs verwenden. Weitere Informationen Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Absichtliche Umsetzung.

Attribute	Typ	Beschreibung
`discreteOnlyOpenClose`	Boolesch	(Standardeinstellung: `false`) Wenn dies auf „true“ gesetzt ist, 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	(Standardeinstellung: `false`) Gibt an, ob das Gerät die unidirektionale (wahr) oder bidirektionale (falsche) Kommunikation unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät nicht auf einen QUERY-Intent oder „Report State“ für dieses Merkmal reagieren kann.
`queryOnlyOpenClose`	Boolesch	(Standardeinstellung: `false`) Gibt an, ob das Gerät nur Statusinformationen abgefragt und nicht gesteuert werden kann. Bei Sensoren, die nur den Status „Geöffnet“ melden können, sollte dieses Feld auf „true“ gesetzt werden.

Beispiele

Einfaches Gerät zum Öffnen und Schließen.

{
  "discreteOnlyOpenClose": true
}

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

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

Nur Befehl.

{
  "commandOnlyOpenClose": false
}

Gerät: STATES

Entitäten mit diesem Merkmal melden möglicherweise Folgendes: QUERY-Bundesstaaten. Weitere Informationen Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Absichtliche Umsetzung.

Die Nutzlast enthält eines der folgenden Elemente:

Einbahnstraße (Offen/Geschlossen)

Bundesstaaten Typ Beschreibung

Bundesstaaten	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt den Prozentsatz an, zu dem ein Gerät geöffnet ist, wobei 0 geschlossen und 100 vollständig geöffnet ist.
`targetOpenPercent`	Number	Pegel, der den Öffnungsprozentsatz angibt, zu dem das Gerät aufgrund einer fortlaufenden Positionsänderung hin- und herspringen wird.

openPercent

Number

Erforderlich.

Gibt den Prozentsatz an, zu dem ein Gerät geöffnet ist, wobei 0 geschlossen und 100 vollständig geöffnet ist.

targetOpenPercent

Number

Pegel, der den Öffnungsprozentsatz angibt, zu dem das Gerät aufgrund einer fortlaufenden Positionsänderung hin- und herspringen wird.

Mehrere Richtungen öffnen/schließen

Bundesstaaten	Typ	Beschreibung
`openState`	Array	Erforderlich. Liste der Status für jede unterstützte Richtung.
`[item, ...]`	Objekt	Aktueller Status für die angegebene Öffnungsrichtung.
`openPercent`	Number	Erforderlich. Gibt den Prozentsatz an, zu dem ein Gerät geöffnet ist, wobei 0 geschlossen und 100 vollständig geöffnet ist.
`targetOpenPercent`	Number	Pegel, der den Öffnungsprozentsatz angibt, zu dem das Gerät aufgrund einer fortlaufenden Positionsänderung hin- und herspringen wird.
`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 Öffnen/Schließen-Gerät, das sich in einer neuen Position öffnet.

{
  "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"
    }
  ]
}

Öffne das Gerät um 30% nach unten und um 50% nach oben. Derzeit bewegt sich das Gerät auf 80% nach oben.

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

Gerät "COMMANDS"

Geräte mit diesem Merkmal können auf Folgendes reagieren im Rahmen des EXECUTE-Vorgangs ausgeführt. Weitere Informationen Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Absichtliche Umsetzung.

`action.devices.commands.OpenClose`

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

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt den Prozentsatz an, zu dem 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, wie durch das Attribut `openDirection` angegeben, mehrere Richtungen unterstützt und vom Nutzer eine Richtung angegeben wurde. Unterstützte Werte: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Von Google bereitgestelltes Token für die weiterführende Antwort.

openPercent

Number

Erforderlich.

Gibt den Prozentsatz an, zu dem 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, wie durch das Attribut openDirection angegeben, mehrere Richtungen unterstützt und vom Nutzer eine Richtung angegeben wurde.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

followUpToken

String

Von Google bereitgestelltes Token für die weiterführende Antwort.

Beispiele

Öffne das Gerät.

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

Öffne das Gerät um 50 % herunter.

{
  "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

Anschlussantworten

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

Die Nutzlast enthält eines der folgenden Elemente:

Erfolg

Felder Typ Beschreibung

Felder	Typ	Beschreibung
`followUpToken`	String	Erforderlich. Token in der ursprünglichen EXECUTE-Anfrage.
`status`	String	Erforderlich. Ergebnis der Anfrage Unterstützte Werte: `SUCCESS`
`openPercent`	Number	Erforderlich. Gibt den Prozentsatz an, bei dem ein Gerät geöffnet ist, wobei „0“ geschlossen und 100 vollständig geöffnet ist.

followUpToken

String

Erforderlich.

Token in der ursprünglichen EXECUTE-Anfrage.

status

String

Erforderlich.

Ergebnis der Anfrage

Unterstützte Werte:

SUCCESS

openPercent

Number

Erforderlich.

Gibt den Prozentsatz an, bei dem 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 in der ursprünglichen EXECUTE-Anfrage.
`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`.

followUpToken

String

Erforderlich.

Token in der ursprünglichen EXECUTE-Anfrage.

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 für eine erfolgreiche Anfrage)

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

Öffne das Garagentor. (Folgeantwort auf Fehler bei Fall)

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

`action.devices.commands.OpenCloseRelative`

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

Für diesen Befehl sind folgende Attribute erforderlich:

{
  "commandOnlyOpenClose": false
}

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openRelativePercent`	Number	Erforderlich. Der genaue Prozentsatz zum Ändern des Öffnungs-/Schließstatus. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt (z. B. „Öffne die Jalousien etwas mehr“ statt „Öffne die Jalousien um 5 %“).
`openDirection`	String	Richtung, in die geöffnet werden soll. Ist nur vorhanden, wenn das Gerät, wie durch das Attribut `openDirection` angegeben, mehrere Richtungen unterstützt und vom Nutzer eine Richtung angegeben wurde. Unterstützte Werte: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Number

Erforderlich.

Der genaue Prozentsatz zum Ändern des Öffnungs-/Schließstatus. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt (z. B. „Öffne die Jalousien etwas mehr“ statt „Öffne die Jalousien um 5 %“).

openDirection

String

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Öffne das Gerät noch ein bisschen

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

Schließen Sie das Gerät um 10% weiter.

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

Öffne das Gerät um 50% weiter 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ätefehler

Vollständige Liste der Fehler und Ausnahmen.

Schema für Smart-Home-Open-Close-Trait

Geräte-ATTRIBUTES

Beispiele

Gerät: STATES

Einbahnstraße (Offen/Geschlossen)

Mehrere Richtungen öffnen/schließen

Beispiele

Gerät "COMMANDS"

action.devices.commands.OpenClose

Parameter

Beispiele

Ähnliche Fehler

Anschlussantworten

Erfolg

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ätefehler

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`