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 im Rahmen des Vorgangs SYNC die folgenden Attribute 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
  • schließe die Rollläden ein bisschen mehr
  • Öffne die Jalousien um 25%

en-US

  • 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
  • quiero que subas la persiana al 25%
  • sube un 20% las persianas

fr-FR

  • baisse les stores de 10%
  • 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%

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
  • open de gordijnen
  • sluit het gordijn
  • zet de luxaflex voor 50% open

pt-BR

  • Abrir janela 50%
  • Fecha a persiana toda
  • Fechar a janela 10%
  • 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
  • öppna persiennerna med 25%

Gerät ERRORS

Vollständige Liste der Fehler und Ausnahmen