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 die Open-Close-Trait-Funktion von Smart Home

action.devices.traits.OpenClose: Diese Eigenschaft bezieht sich auf Geräte, die sich öffnen und schließen lassen, in einigen Fällen teilweise oder möglicherweise 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 zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Attribute	Typ	Beschreibung
`discreteOnlyOpenClose`	Boolesch	(Standardeinstellung: `false`) Wenn dieser Wert auf „wahr“ gesetzt ist, muss das Gerät entweder vollständig geöffnet oder vollständig geschlossen sein. Es werden also keine Werte zwischen 0 % und 100 % unterstützt.
`openDirection`	Array	Liste der unterstützten Richtungen, in denen sich das Gerät öffnen oder schließen lässt. Fügen Sie dieses Attribut hinzu, wenn das Gerät in mehr als einer Richtung geöffnet und geschlossen werden kann.
`[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 (falsch) Kommunikation unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät nicht auf eine QUERY-Intention oder den Berichtsstatus für dieses Attribut antworten kann.
`queryOnlyOpenClose`	Boolesch	(Standardeinstellung: `false`) Gibt an, ob das Gerät nur zu Statusinformationen abgefragt und nicht gesteuert werden kann. Bei Sensoren, die nur den geöffneten Zustand melden können, sollte dieses Feld auf „wahr“ gesetzt werden.

Beispiele

Einfaches Öffnen und Schließen des Geräts.

{
  "discreteOnlyOpenClose": true
}

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

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

Nur Befehlsgerät

{
  "commandOnlyOpenClose": false
}

GERÄTESTATUS

Entitäten mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Status melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Ausführung.

Die Nutzlast enthält Folgendes:

Einseitig öffnen und schließen

Bundesstaaten Typ Beschreibung

Bundesstaaten	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt den Prozentsatz an, in dem ein Gerät geöffnet ist. 0 bedeutet „geschlossen“ und 100 „vollständig geöffnet“.
`targetOpenPercent`	Number	Stufe, die den Prozentsatz der Öffnung angibt, zu der das Gerät aufgrund einer laufenden Positionsänderung gelangt oder sich bewegt.

openPercent

Number

Erforderlich.

Gibt den Prozentsatz an, in dem ein Gerät geöffnet ist. 0 bedeutet „geschlossen“ und 100 „vollständig geöffnet“.

targetOpenPercent

Number

Stufe, die den Prozentsatz der Öffnung angibt, zu der das Gerät aufgrund einer laufenden Positionsänderung gelangt oder sich bewegt.

Öffnungs-/Schließrichtung mehrmals ändern

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, in dem ein Gerät geöffnet ist. 0 bedeutet „geschlossen“ und 100 „vollständig geöffnet“.
`targetOpenPercent`	Number	Pegel, der den Öffnungsprozentsatz angibt, zu dem das Gerät aufgrund einer fortlaufenden Positionsänderung hin- und herbewegt 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 derzeit in eine neue Position öffnet.

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

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

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

Gerät um 30 % nach unten und um 50 % nach oben öffnen, derzeit wird es um 80 % nach oben bewegt.

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

BEFEHLE für Geräte

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

`action.devices.commands.OpenClose`

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

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt den Prozentsatz an, in dem ein Gerät geöffnet ist. 0 bedeutet „geschlossen“ und 100 „vollständig geöffnet“.
`openDirection`	String	Richtung, in die geöffnet werden soll. 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 Antwort auf das Ersuchen.

openPercent

Number

Erforderlich.

Gibt den Prozentsatz an, in dem ein Gerät geöffnet ist. 0 bedeutet „geschlossen“ und 100 „vollständig geöffnet“.

openDirection

String

Richtung, in die geöffnet werden soll. 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 Antwort auf das Ersuchen.

Beispiele

Öffnen Sie das Gerät.

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

Öffnen Sie das Gerät zu 50 %.

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

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

Unterstützte Werte:

lockedState
deviceJammingDetected

Folgeantworten

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

Die Nutzlast enthält Folgendes:

Erfolg

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 den Prozentsatz an, in dem ein Gerät geöffnet ist. 0 % bedeutet „geschlossen“ und 100 % „vollständig geöffnet“.

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 den Prozentsatz an, in dem ein Gerät geöffnet ist. 0 % bedeutet „geschlossen“ und 100 % „vollständig geöffnet“.

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 dieses Attribut 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 dieses Attribut sein, z. B. lockedState.

Beispiele

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

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

Öffnen Sie das Garagentor. (Folgeantwort bei Fehlerfall)

{
  "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 die folgenden Attribute erforderlich:

{
  "commandOnlyOpenClose": false
}

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openRelativePercent`	Number	Erforderlich. Der genaue Prozentsatz, um den Status „Geöffnet“ zu ändern. Zweideutige relative Befehle werden in einen genauen Prozentsatzparameter umgewandelt (z. B. „Öffnen Sie die Jalousien ein bisschen weiter“ im Vergleich zu „Öffnen Sie die Jalousien um 5 %“).
`openDirection`	String	Richtung, in die geöffnet werden soll. 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, um den Status „Geöffnet“ zu ändern. Zweideutige relative Befehle werden in einen genauen Prozentsatzparameter umgewandelt (z. B. „Öffnen Sie die Jalousien ein bisschen weiter“ im Vergleich zu „Öffnen Sie die Jalousien um 5 %“).

openDirection

String

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

Beispiele

Öffne das Gerät noch ein bisschen

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

10 % schneller schließen

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

Gerät 50 % weiter nach unten öffnen

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

Beim Festlegen des Öffnungs-/Schließungsstatus 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

Eine vollständige Liste der Fehler und Ausnahmen

Schema für die Open-Close-Trait-Funktion von Smart Home

Geräteattribute

Beispiele

GERÄTESTATUS

Einseitig öffnen und schließen

Öffnungs-/Schließrichtung mehrmals ändern

Beispiele

BEFEHLE für Geräte

action.devices.commands.OpenClose

Parameter

Beispiele

Ähnliche Fehler

Folgeantworten

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`