Schemat inteligentnego domu OpenOpen
action.devices.traits.OpenClose
– ten atrybut należy do urządzeń, które umożliwiają otwieranie i zamykanie, a w niektórych przypadkach częściowo lub potencjalnie w kilku kierunkach.
ATRYBUTY urządzenia
W ramach operacji SYNC
urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC
znajdziesz w sekcji Realizacja intencji.
Atrybuty | Typ | Opis |
---|---|---|
discreteOnlyOpenClose |
Wartość logiczna |
(domyślnie: Jeśli ma wartość Prawda, oznacza to, że urządzenie musi być w pełni otwarte lub zamknięte (to znaczy, że nie obsługuje wartości od 0% do 100%). |
openDirection |
Tablica |
Lista obsługiwanych kierunków, w których urządzenie może się otworzyć lub zamknąć. Dodaj ten atrybut, jeśli urządzenie obsługuje otwieranie i zamykanie w więcej niż jednym kierunku. |
[item, ...] |
Ciąg |
Obsługiwany kierunek. Obsługiwane wartości:
|
commandOnlyOpenClose |
Wartość logiczna |
(domyślnie: Wskazuje, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość „true”, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu. |
queryOnlyOpenClose |
Wartość logiczna |
(domyślnie: Wskazuje, czy na urządzeniu można wysyłać zapytania tylko o informacje dotyczące stanu i nie można nim sterować. Czujniki, które mogą raportować tylko stan otwarty, powinny mieć wartość Prawda. |
Przykłady
Proste urządzenie z otwartym zamykaniem.
{ "discreteOnlyOpenClose": true }
Urządzenie od dołu do góry. Można go otworzyć w dowolnym kierunku.
{ "openDirection": [ "UP", "DOWN" ] }
Urządzenie tylko na polecenie.
{ "commandOnlyOpenClose": true }
Urządzenie STATES
W ramach operacji QUERY
urządzenia z tą cechą mogą zawierać podane niżej stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Ładunek zawiera jeden z tych elementów:
1-kierunkowo z możliwością zamknięcia
Stany | Typ | Opis |
---|---|---|
openPercent |
Number |
Wymagany. Wskazuje odsetek otworzeń urządzenia, w których 0 jest zamknięte, a 100 – pełne otwarcie. |
Otwarty/zamknięty w wielu kierunkach
Stany | Typ | Opis |
---|---|---|
openState |
Tablica |
Wymagany. Lista stanów dla każdego obsługiwanego kierunku otwartego. |
[item, ...] |
Obiekt |
Stan obecny dla danego otwartego kierunku. |
openPercent |
Number |
Wymagany. Wskazuje odsetek otworzeń urządzenia, w których 0 jest zamknięte, a 100 – pełne otwarcie. |
openDirection |
Ciąg |
Wymagany. Kierunek, w którym jest otwarte urządzenie. Obsługiwane wartości:
|
Przykłady
Proste urządzenie z otwartym zamykaniem.
{ "openPercent": 100 }
Otwórz urządzenie o 30% i o 50% w dół.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
Polecenie urządzenia
W ramach operacji EXECUTE
urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.OpenClose
Ustaw stan „otwarcia” na urządzeniu.
Parametry
Parametry | Typ | Opis |
---|---|---|
openPercent |
Number |
Wymagany. Wskazuje odsetek otworzeń urządzenia, w których 0 jest zamknięte, a 100 – pełne otwarcie. |
openDirection |
Ciąg |
Kierunek, w którym można otworzyć. Atrybut występuje tylko wtedy, gdy urządzenie obsługuje wiele wskazówek dojazdu określonych w atrybucie Obsługiwane wartości:
|
followUpToken |
Ciąg |
Token Google dostarczony w ramach dalszej odpowiedzi. |
Przykłady
Otwórz urządzenie.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 100, "followUpToken": "123" } }
Otwórz urządzenie w dół o 50%.
{ "command": "action.devices.commands.OpenClose", "params": { "openPercent": 50, "openDirection": "DOWN", "followUpToken": "456" } }
Powiązane błędy
Podczas ustawiania stanu otwierania i zamykania urządzenia wystąpił błąd.
Obsługiwane wartości:
lockedState
deviceJammingDetected
Odpowiedzi uzupełniające
Urządzenia z tym atrybutem mogą zwrócić w ramach operacji EXECUTE
ten ładunek odpowiedzi uzupełniających. Więcej informacji o wdrażaniu dalszych odpowiedzi znajdziesz w artykule Powiadomienia dotyczące inteligentnych działań w domu.
Ładunek zawiera jeden z tych elementów:
Sukces
Pola | Typ | Opis |
---|---|---|
followUpToken |
Ciąg |
Wymagany. Token podany w pierwotnym żądaniu EXECUTE. |
status |
Ciąg |
Wymagany. Wynik żądania. Obsługiwane wartości:
|
openPercent |
Number |
Wymagany. Wskazuje odsetek otwarcia urządzenia przez 0 i 100 po otwarciu. |
Niepowodzenie
Pola | Typ | Opis |
---|---|---|
followUpToken |
Ciąg |
Wymagany. Token podany w pierwotnym żądaniu EXECUTE. |
status |
Ciąg |
Wymagany. Wynik żądania. Obsługiwane wartości:
|
errorCode |
Ciąg |
Wymagany. Wartością może być dowolny kod błędu dla tego atrybutu, na przykład |
Przykłady
Otwórz drzwi do garażu. (dalsza odpowiedź w przypadku sukcesu)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Otwórz drzwi do garażu. (dalsza odpowiedź w przypadku niepowodzenia)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Dostosuj stan otwierania i zamykania urządzenia względem bieżącego stanu. To polecenie jest dostępne tylko wtedy, gdy commandOnlyOpenClose
ma wartość true
.
{ "commandOnlyOpenClose": true }
Parametry
Parametry | Typ | Opis |
---|---|---|
openRelativePercent |
Number |
Wymagany. Dokładny procent zmiany stanu zamknięcia. Niejednoznaczne polecenia względne zostaną przekonwertowane na parametr procentowy (np. „Otwórz więcej żaluzji” zamiast „Otwórz rolety o 5%”). |
openDirection |
Ciąg |
Kierunek, w którym można otworzyć. Atrybut występuje tylko wtedy, gdy urządzenie obsługuje wiele wskazówek dojazdu określonych w atrybucie Obsługiwane wartości:
|
Przykłady
Otwórz urządzenie trochę częściej
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Zamknij urządzenie o 10%
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
O 50% więcej urządzenia w dół.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Powiązane błędy
Podczas ustawiania stanu otwierania i zamykania urządzenia wystąpił błąd.
Obsługiwane wartości:
lockedState
deviceJammingDetected
Przykładowe wypowiedzi
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%