OpenClose-Trait-Schema für Smart Home
action.devices.traits.OpenClose
: Diese Eigenschaft gehört zu Geräten, die das Öffnen und Schließen sowie in einigen Fällen das Öffnen und Schließen teilweise oder möglicherweise auch in mehrere Richtungen unterstützen.
Geräte-ATTRIBUTE
Geräte mit dieser Eigenschaft melden möglicherweise die folgenden Attribute im Rahmen des Vorgangs SYNC
. Weitere Informationen zur Verarbeitung von 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 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:
|
commandOnlyOpenClose |
Boolesch |
(Standard: Gibt an, ob das Gerät die bidirektionale (richtig) oder bidirektionale (falsch) Kommunikation unterstützt. Setze dieses Attribut auf „true“, wenn das Gerät für dieses Merkmal 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 Öffnungsstatus melden können, sollte dieses Feld auf „true“ gesetzt werden. |
Beispiele
Einfaches Öffnen und Schließen
{ "discreteOnlyOpenClose": true }
Top-down-Bottom-up-Gerät. 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 Merkmal können die folgenden Status als Teil des Vorgangs QUERY
melden. Weitere Informationen zur Verarbeitung von 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 geschlossen und 100 vollständig geöffnet ist. |
targetOpenPercent |
Number |
Stufe, die den Prozentsatz angibt, zu dem das Gerät aufgrund einer laufenden Positionsänderung geöffnet wird bzw. in das es bewegt wird. |
Öffnen/Schließen in mehrere Richtungen
Bundesstaaten | Typ | Beschreibung |
---|---|---|
openState |
Array |
Erforderlich. Liste der Status für jede unterstützte Öffnungsrichtung. |
[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 geschlossen und 100 vollständig geöffnet ist. |
targetOpenPercent |
Number |
Stufe, die den Prozentsatz angibt, zu dem das Gerät aufgrund einer laufenden Positionsänderung geöffnet wird bzw. in das es bewegt wird. |
openDirection |
String |
Erforderlich. Richtung, in die das Gerät geöffnet wird. Unterstützte Werte:
|
Beispiele
Einfaches Öffnen und Schließen
{ "openPercent": 100 }
Einfaches Öffnen/Schließen. Das Gerät öffnet sich derzeit in einer neuen Position.
{ "openPercent": 50, "targetOpenPercent": 100 }
Öffne das Gerät um 30% nach unten und um 50% nach oben.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
Gerät wird um 30% nach unten und um 50% nach oben geöffnet; derzeit bewegt sich das Gerät um 80% nach oben.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "targetOpenPercent": 80, "openDirection": "UP" } ] }
BEFEHLE auf Gerät
Geräte mit diesem Trait können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zur Verarbeitung von EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.OpenClose
Legt den Öffnungs-/Schließzustand des Geräts fest.
Parameters
Parameters | Typ | Beschreibung |
---|---|---|
openPercent |
Number |
Erforderlich. Gibt an, wie viel Prozent 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. Ist nur vorhanden, wenn das Gerät gemäß dem Attribut Unterstützte Werte:
|
followUpToken |
String |
Von Google bereitgestelltes Token für die Follow-up-Antwort. |
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 Einrichten des Öffnungs-/Schließstatus ist ein Fehler aufgetreten.
Unterstützte Werte:
lockedState
deviceJammingDetected
Folgeantworten
Geräte mit dieser Eigenschaft können die folgende Nutzlast der Folgeantwort als Teil des Vorgangs EXECUTE
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 bereitgestellt 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 zu 100 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:
|
errorCode |
String |
Erforderlich. Der Wert kann ein beliebiger Fehlercode für dieses Merkmal 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
Stellt den Öffnungs-/Schließstatus des Geräts relativ zum aktuellen Zustand ein. Dieser Befehl ist nur verfügbar, wenn commandOnlyOpenClose
auf false
gesetzt ist.
{ "commandOnlyOpenClose": false }
Parameters
Parameters | Typ | Beschreibung |
---|---|---|
openRelativePercent |
Number |
Erforderlich. Der genaue Prozentsatz für die Änderung des Öffnungs-/Schließzustands. Mehrdeutige relative Befehle werden in einen exakten Prozentparameter umgewandelt (z. B. „Lass die Jalousien etwas weiter öffnen“ oder „Öffne die Jalousien um 5 %“). |
openDirection |
String |
Richtung, in die geöffnet werden soll. Ist nur vorhanden, wenn das Gerät gemäß dem Attribut Unterstützte Werte:
|
Beispiele
Öffne das Gerät ein wenig mehr.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Gerät um 10% schließen
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Auf dem Gerät 50% mehr nach unten öffnen
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Ähnliche Fehler
Beim Einrichten des Öffnungs-/Schließstatus 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%