Willkommen beim Google Home Developer Center, der neuen Anlaufstelle für Smart-Home-Aktionen. Hinweis:Sie erstellen weiterhin Aktionen in der Actions Console.
Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Schema zum Öffnen und Schließen eines Smart Home

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

Gerät ATTRIBUTE

Geräte mit diesem Attribut können die folgenden Attribute als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

Attribute Typ Beschreibung
discreteOnlyOpenClose Boolesch

(Standard: false)

Wenn dieser Wert auf „true“ gesetzt ist, muss das Gerät entweder vollständig geöffnet oder vollständig geschlossen sein (d. h. keine Werte zwischen 0% und 100 % unterstützt werden).

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 Einweg- (wahr) oder Zwei-Wege-Kommunikation (falsch) unterstützt. Legen Sie dieses Attribut auf „true“ fest, wenn das Gerät für einen dieser Merkmale nicht auf einen QUERY-Intent oder einen Berichtsstatus reagieren kann.

queryOnlyOpenClose Boolesch

(Standard: false)

Gibt an, ob das Gerät nur für Statusinformationen abgefragt werden kann und nicht gesteuert werden kann. Sensoren, die nur den Status „Offen“ melden können, müssen für dieses Feld „true“ festgelegt werden.

Beispiele

Einfaches Gerät zum Öffnen und Schließen

{
  "discreteOnlyOpenClose": true
}

Drauf Kann in beide Richtungen geöffnet werden.

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

Gerät, auf dem nur Befehle ausgeführt werden können.

{
  "commandOnlyOpenClose": true
}

Gerät STATES

Geräte mit diesem Attribut können im Rahmen des Vorgangs QUERY die folgenden Zustände melden. Weitere Informationen zum Umgang mit QUERY-Intents finden Sie unter Intent-Auftragsausführung.

Die Nutzlast enthält einen der folgenden Werte:

Einzelrichtung Offen/Schließen

Bundesstaaten Typ Beschreibung
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.

Richtung/Schließen mehrerer Richtungen

Bundesstaaten Typ Beschreibung
openState Array

Erforderlich.

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

[item, ...] Objekt

Aktueller Status für die angegebene Öffnungsrichtung.

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.

openDirection String

Erforderlich.

Richtung, in der das Gerät geöffnet ist.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Einfaches Gerät zum Öffnen und Schließen

{
  "openPercent": 100
}

30% nach unten und 50% nach oben öffnen.

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

Gerätebefehle

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

action.devices.commands.OpenClose

Hiermit wird der Öffnungs-/Schließstatus des Geräts festgelegt.

Parameter

Parameter Typ Beschreibung
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.

openDirection String

Richtung, in die geöffnet werden soll. Nur vorhanden, wenn das Gerät mehrere Richtungen unterstützt, wie durch das Attribut openDirection angegeben, und eine Richtung durch den Nutzer angegeben ist.

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

Öffne das Gerät 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 diesem Attribut können die folgende Antwortantwortantwort als Teil des Vorgangs EXECUTE zurückgeben. Weitere Informationen zum Implementieren von Folgeantworten finden Sie unter Benachrichtigungen für Smart-Home-Aktionen.

Die Nutzlast enthält einen der folgenden Werte:

Erfolg

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 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
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 diese Eigenschaft sein, z. B. lockedState.

Beispiele

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

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

Öffne das Garagentor. (Folgeantwort auf Fehler)

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

action.devices.commands.OpenCloseRelative

Hiermit wird der Öffnungs-/Schließstatus des Geräts im Verhältnis zum aktuellen Zustand angepasst. Dieser Befehl ist nur verfügbar, wenn commandOnlyOpenClose auf true gesetzt ist.

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

Parameter

Parameter Typ Beschreibung
openRelativePercent Number

Erforderlich.

Der genaue Prozentsatz, um den Öffnungs-/Schließstatus zu ändern. Mehrdeutige relative Befehle werden in einen exakten prozentualen Parameter umgewandelt, z. B. „Öffne die Jalousien etwas weiter“ statt „Die Jalousien um 5 % öffnen“.

openDirection String

Richtung, in die geöffnet werden soll. Nur vorhanden, wenn das Gerät mehrere Richtungen unterstützt, wie durch das Attribut openDirection angegeben, und eine Richtung durch den Nutzer angegeben ist.

Unterstützte Werte:

UP
DOWN
LEFT
RIGHT
IN
OUT

Beispiele

Öffne das Gerät etwas häufiger

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

Gerät um 10% schließen

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

Öffne 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
  • Mach den Rollladen zu
  • Mach Die Rollos auf
  • Die Rollläden ein bisschen
  • Offen die Jalousien um 25 %

en-US

  • die Jalousien schließen 25% mein Zimmer
  • Tür schließen Mehr erfahren
  • Schließe die Haustür.
  • die Jalousien in meinem Zimmer öffnen
  • die Jalousien öffnen, um 25 % zu öffnen
  • Tür öffnen um 25%

es-ES

  • abre la ventana del salón
  • Cerrar persianas delsleepitorio un 20%
  • Cierra la cortina del salón
  • Cierra mucho más la ventana
  • quiero que subas la persiana al 25 %
  • sub-un 20 % las persianas

fr-FR

  • baisse les stores de 10 %
  • ferme Geschäfte
  • ferme un peu les stores
  • ouvre les Geschäfte
  • 25%
  • ouvre les stores à 25%

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen