Schema für Smart-Home-OpenClose-Trait
action.devices.traits.OpenClose
: Diese Eigenschaft gehört zu Geräten, die das Öffnen und Schließen unterstützen. In einigen Fällen können das Öffnen und Schließen auch teilweise oder in mehrere Richtungen erfolgen.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des SYNC
-Vorgangs. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
discreteOnlyOpenClose |
Boolesch |
(Standard: Ist die Richtlinie auf „true“ gesetzt, 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 die das Gerät geöffnet oder geschlossen werden kann. Verwenden Sie dieses Attribut, wenn das Gerät das Öffnen und Schließen in mehrere Richtungen unterstützt. |
[item, ...] |
String |
Unterstützte Richtung. Unterstützte Werte:
|
commandOnlyOpenClose |
Boolesch |
(Standard: Gibt an, ob das Gerät die unidirektionale (wahr) oder die bidirektionale (falsche) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für diese Eigenschaft nicht auf einen QUERY-Intent oder Berichtsstatus reagieren kann. |
queryOnlyOpenClose |
Boolesch |
(Standard: Gibt an, ob das Gerät nur Statusinformationen abgefragt und nicht gesteuert werden kann. Bei Sensoren, die nur den offenen Zustand melden können, sollte dieses Feld auf „true“ gesetzt werden. |
Beispiele
Einfaches Öffnen-/Schließen-Gerät
{ "discreteOnlyOpenClose": true }
Top-down-Gerät von unten nach oben. Sie können in beide Richtungen geöffnet werden.
{ "openDirection": [ "UP", "DOWN" ] }
Gerät nur mit Sprachbefehlen
{ "commandOnlyOpenClose": false }
Gerät STATES
Entitäten mit diesem Trait können die folgenden Status im Rahmen des QUERY
-Vorgangs melden. Weitere Informationen zum Umgang mit QUERY
-Intents finden Sie unter Intent-Auftragsausführung.
Die Nutzlast enthält eines der folgenden Elemente:
Öffnen/Schließen in eine Richtung
Bundesstaaten | Typ | Beschreibung |
---|---|---|
openPercent |
Number |
Erforderlich. Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 für geschlossen und 100 vollständig geöffnet ist. |
Öffnen/Schließen in mehrere Richtungen
Bundesstaaten | Typ | Beschreibung |
---|---|---|
openState |
Array |
Erforderlich. Liste der Zustände für jede unterstützte offene Richtung. |
[item, ...] |
Objekt |
Aktueller Status für die angegebene Öffnungsrichtung. |
openPercent |
Number |
Erforderlich. Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 für geschlossen und 100 vollständig geöffnet ist. |
openDirection |
String |
Erforderlich. Richtung, in die das Gerät geöffnet wird. Unterstützte Werte:
|
Beispiele
Einfaches Öffnen-/Schließen-Gerät
{ "openPercent": 100 }
Öffnen Sie das Gerät um 30% nach unten und um 50% nach oben.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
BEFEHLUNGEN auf dem Gerät
Geräte mit dieser Eigenschaft können im Rahmen des EXECUTE
-Vorgangs auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.OpenClose
Legt den Öffnungs-/Schließstatus des Geräts fest.
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
openPercent |
Number |
Erforderlich. Gibt an, wie viel Prozent ein Gerät geöffnet ist, wobei 0 für geschlossen und 100 vollständig geöffnet ist. |
openDirection |
String |
Richtung, in die geöffnet werden soll. Ist nur vorhanden, wenn das Gerät mehrere Richtungen unterstützt, wie durch das Attribut Unterstützte Werte:
|
followUpToken |
String |
Von Google bereitgestelltes Token für die Folgeantwort. |
Beispiele
Öffne das Gerät.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
Öffne das Gerät um 50 % nach unten.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Ähnliche Fehler
Beim Festlegen des Öffnungs-/Schließstatus des Geräts ist ein Fehler aufgetreten.
Unterstützte Werte:
lockedState
deviceJammingDetected
Folgeantworten
Geräte mit dieser Eigenschaft können als Teil des EXECUTE
-Vorgangs die folgende Nutzlast der Folgeantwort zurückgeben. Weitere Informationen zum Implementieren von Folgeantworten findest du unter Benachrichtigungen für Smart-Home-Aktionen.
Die Nutzlast enthält eines der folgenden Elemente:
Abgeschlossen
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:
|
openPercent |
Number |
Erforderlich. Gibt an, wie viel Prozent 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 angegeben wurde. |
status |
String |
Erforderlich. Ergebnis der Anfrage. Unterstützte Werte:
|
errorCode |
String |
Erforderlich. Der Wert kann ein beliebiger Fehlercode für diese Eigenschaft sein, z. B. |
Beispiele
Öffne das Garagentor. (Folgeantwort bei Erfolgsfall)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Öffne das Garagentor. (Folgeantwort bei Fehlerfall)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Passen Sie den Öffnungs-/Schließstatus des Geräts in Bezug auf den aktuellen Status an. Dieser Befehl ist nur verfügbar, wenn commandOnlyOpenClose
auf false
gesetzt ist.
{ "commandOnlyOpenClose": false }
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
openRelativePercent |
Number |
Erforderlich. Der genaue Prozentsatz für die Änderung des Öffnungs-/Schließstatus. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt, z. B. „Die Jalousien etwas mehr öffnen“ oder „Die Jalousien um 5 % öffnen“. |
openDirection |
String |
Richtung, in die geöffnet werden soll. Ist nur vorhanden, wenn das Gerät mehrere Richtungen unterstützt, wie durch das Attribut Unterstützte Werte:
|
Beispiele
Öffne das Gerät etwas mehr.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Schließe das Gerät noch 10%
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Öffnen Sie das Gerät um 50% nach unten.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Ähnliche Fehler
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%