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 zum Öffnen und Schließen von Smart Homes

action.devices.traits.OpenClose: Dieser Wert gilt für Geräte, die das Öffnen und Schließen unterstützen und in einigen Fällen teilweise oder möglicherweise in mehr als einer Richtung öffnen und schließen.

Geräte-ATTRIBUTE

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

Attribute	Typ	Beschreibung
`discreteOnlyOpenClose`	Boolesch	(Standard: `false`) Bei der Einstellung „true“ muss das Gerät entweder vollständig geöffnet oder vollständig geschlossen sein, d. h. es werden 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 Verwendung von Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Setzen Sie dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder einen Berichtstatus reagieren kann.
`queryOnlyOpenClose`	Boolesch	(Standard: `false`) Gibt an, ob das Gerät nur für Statusinformationen abgefragt werden und nicht gesteuert werden kann. Sensoren, die nur den offenen Status melden können, sollten dieses Feld auf „true“ setzen.

Beispiele

Einfaches Gerät zum Schließen.

{
  "discreteOnlyOpenClose": true
}

Gerät, das von oben nach unten steht Sie können in beide Richtungen geöffnet werden.

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

Ein Gerät, das nur auf Befehl ausgeführt werden kann.

{
  "commandOnlyOpenClose": false
}

Gerätestatus

Entitäten mit diesem Merkmal können im Rahmen des QUERY-Vorgangs die folgenden Status melden: Weitere Informationen zum Verarbeiten von QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Die Nutzlast enthält eine der folgenden Optionen:

Single Direction Offen/Schließen

Bundesstaaten Typ Beschreibung

Bundesstaaten	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt an, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100 sind vollständig geöffnet).

openPercent

Number

Erforderlich.

Gibt an, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100 sind vollständig geöffnet).

Richtung Richtung „Schließen“/„Schließen“

Bundesstaaten	Typ	Beschreibung
`openState`	Array	Erforderlich. Liste der Status für jede unterstützte offene Richtung.
`[item, ...]`	Objekt	Aktueller Status für die angegebene Richtung.
`openPercent`	Number	Erforderlich. Gibt an, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100 sind vollständig geöffnet).
`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 Schließen.

{
  "openPercent": 100
}

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

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

BEISPIELE für Geräte

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

`action.devices.commands.OpenClose`

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

Parameter

Parameter Typ Beschreibung

Parameter	Typ	Beschreibung
`openPercent`	Number	Erforderlich. Gibt an, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100 sind vollständig geöffnet).
`openDirection`	String	Richtung, in der die Datei geöffnet werden soll. Nur vorhanden, wenn das Gerät mehrere Routen unterstützt, wie durch das Attribut `openDirection` angegeben, und vom Nutzer eine Richtung 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, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100 sind vollständig geöffnet).

openDirection

String

Richtung, in der die Datei geöffnet werden soll. Nur vorhanden, wenn das Gerät mehrere Routen unterstützt, wie durch das Attribut openDirection angegeben, und vom Nutzer eine Richtung angegeben wird.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

followUpToken

String

Von Google bereitgestelltes Token für die Folgeantwort.

Beispiele

Öffnen Sie das Gerät.

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

Gerät zu 50 % öffnen.

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

Beim Festlegen des Zustands zum Öffnen und Schließen des Geräts ist ein Fehler aufgetreten.

Unterstützte Werte:

lockedState
deviceJammingDetected

Weitere Antworten

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

Die Nutzlast enthält eine der folgenden Optionen:

Erfolg

Felder Typ Beschreibung

Felder	Typ	Beschreibung
`followUpToken`	String	Erforderlich. Token aus der ursprünglichen EXECUTE-Anfrage.
`status`	String	Erforderlich. Ergebnis der Anfrage. Unterstützte Werte: `SUCCESS`
`openPercent`	Number	Erforderlich. Gibt an, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100).

followUpToken

String

Erforderlich.

Token aus der ursprünglichen EXECUTE-Anfrage.

status

String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

SUCCESS

openPercent

Number

Erforderlich.

Gibt an, bei wie viel Prozent ein Gerät geöffnet ist (0 und 100).

Fehler

Felder Typ Beschreibung

Felder	Typ	Beschreibung
`followUpToken`	String	Erforderlich. Token aus der ursprünglichen EXECUTE-Anfrage.
`status`	String	Erforderlich. Ergebnis der Anfrage. Unterstützte Werte: `FAILURE`
`errorCode`	String	Erforderlich. Bei dem Wert kann es sich um einen beliebigen Fehlercode für diese Eigenschaft handeln, z. B. `lockedState`.

followUpToken

String

Erforderlich.

Token aus der ursprünglichen EXECUTE-Anfrage.

status

String

Erforderlich.

Ergebnis der Anfrage.

Unterstützte Werte:

FAILURE

errorCode

String

Erforderlich.

Bei dem Wert kann es sich um einen beliebigen Fehlercode für diese Eigenschaft handeln, z. B. lockedState.

Beispiele

Öffne das Garagentor. (Nachfolgen-Antwort für Erfolgsfall)

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

Öffne das Garagentor. (Antwort auf Fehler bei einem Fehler)

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

`action.devices.commands.OpenCloseRelative`

Passe 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 zum Ändern des Öffnungs-/Schließstatus. Umfassende relative Befehle werden in einen genauen Prozentsatz-Parameter umgewandelt (z. B. „Jalousien etwas mehr öffnen“ statt „Jalousien um 5 % öffnen“).
`openDirection`	String	Richtung, in der die Datei geöffnet werden soll. Nur vorhanden, wenn das Gerät mehrere Routen unterstützt, wie durch das Attribut `openDirection` angegeben, und vom Nutzer eine Richtung angegeben wird. Unterstützte Werte: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Number

Erforderlich.

Der genaue Prozentsatz zum Ändern des Öffnungs-/Schließstatus. Umfassende relative Befehle werden in einen genauen Prozentsatz-Parameter umgewandelt (z. B. „Jalousien etwas mehr öffnen“ statt „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
  }
}

Gerät zu 10% mehr schließen

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

Gerät um 50% nach unten öffnen

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

Beim Festlegen des Zustands zum Öffnen und Schließen 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

Hier finden Sie die vollständige Liste der Fehler und Ausnahmen.