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: 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:
|
commandOnlyOpenClose |
Boolesch |
(Standard: 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: 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:
|
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 Unterstützte Werte:
|
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" } }
Ähnliche Fehler
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:
|
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:
|
errorCode |
String |
Erforderlich. Der Wert kann ein beliebiger Fehlercode für diese Eigenschaft sein, z. B. |
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.
{ "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 Unterstützte Werte:
|
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" } }
Ä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 auf30% -
Fensterläden um25 % schliessen -
Mach
den Rollladen zu -
Mach
die Rollos auf -
schließe
die Rollläden ein bisschen mehr -
Öffne
die Jalousien um25%
en-US
-
Close
the blinds 25% inmy room -
Close
the door more -
Just close
the front door -
open
the blinds in my room -
open
the blinds to25% -
open
the door by25%
es-ES
-
abre
la ventana del salón -
cerrar
persianas del dormitorio un20% -
cierra
la cortina del salón -
cierra
mucho másla ventana -
quiero que subas
la persiana al25% -
sube un
20% las persianas
fr-FR
-
baisse
les stores de10% -
ferme
les stores -
ferme
un peu les stores -
ouvre
les stores -
ouvre
les stores de la chambre de25% -
ouvre
les stores à25%
hi-IN
-
कृपया
25% पर्दे को खुला रखो -
पर्दे को25% बंद करोगे -
पर्दे खोलो -
ब्लाइंड 25% खुले पर सेट कर दीजिए -
ब्लाइंड कोथोड़ा और बंद कर दिजिए -
ब्लाइंड बंद करें
it-IT
-
abbassa
un po' di piùle tapparelle -
apri
la serranda -
apri
la tapparella al30% -
apri
le serrande del30% -
chiudi
le serrande -
chiudi
le tende del25%
ja-JP
-
25% にブラインド を開けて -
25% ブラインド を閉めてください -
25% ブラインド 開けて -
ブラインド 閉めて -
ブラインド 開けて -
少し ブラインド を閉じて
ko-KR
-
문 살짝만 닫아 줘 -
블라인드 25% 열어 줘 -
블라인드 25% 까지 열어 줘 -
블라인드 30프로 닫아 -
블라인드 닫아 줘 -
블라인드 열어 줘
nl-NL
-
doe
de gordijnen 25% open -
doe
de jaloezieën voor25% dicht -
doe
het raam ietsje meer dicht -
open
de gordijnen -
sluit
het gordijn -
zet
de luxaflex voor50% 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 a50% -
abrir
as cortinas -
abrir
as cortinas na sala em30% -
fecha
a persiana por favor -
fecha
um bocado a janela -
fechar
as cortinas em25% -
fechar
um pouco maisas cortinas
sv-SE
-
Dra
upp persiennerna -
Dra
upp
persiennerna till25% -
stäng
persiennen i mitt rum 25% -
stäng
persiennerna -
öppna
persiennerna med25%