Schemat punktowy inteligentnego otwierania domu
action.devices.traits.OpenClose
– ta cecha należy do urządzeń, które umożliwiają otwieranie i zamykanie, a w niektórych przypadkach jest to częściowo lub częściowo otwierane w kilku kierunkach.
ATTRIBUTES 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, urządzenie musi być w pełni otwarte lub zamknięte (czyli nie obsługuje wartości od 0% do 100%). |
openDirection |
Tablica |
Lista obsługiwanych wskazówek, przy których urządzenie może się otworzyć lub zamknąć. Uwzględnij ten atrybut, jeśli urządzenie obsługuje otwieranie i zamykanie w więcej niż jednym kierunku. |
[item, ...] |
String |
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 (prawda), 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 można wysyłać zapytania o urządzenia do samych informacji o stanie i której nie można kontrolować. Czujniki, które mogą raportować tylko stan otwarty, powinny mieć wartość Prawda. |
Przykłady
Proste urządzenie zamykające.
{ "discreteOnlyOpenClose": true }
Urządzenie od dołu do góry. Otwarta w każdym kierunku.
{ "openDirection": [ "UP", "DOWN" ] }
Urządzenie tylko na potrzeby polecenia.
{ "commandOnlyOpenClose": false }
Urządzenie STATES
W ramach operacji QUERY
encje z tą cechą mogą zgłaszać wymienione poniżej stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Ładunek zawiera jedną z tych wartości:
Otwieranie i zamykanie z jednego kierunku
Stany | Typ | Opis |
---|---|---|
openPercent |
Number |
Wymagane. Wskazuje odsetek otworzeń urządzenia, gdzie 0 jest zamknięte i 100 jest w pełni otwarte. |
Otwieranie i zamykanie w wielu kierunkach
Stany | Typ | Opis |
---|---|---|
openState |
Tablica |
Wymagane. Lista stanów dla każdego obsługiwanego kierunku otwartego. |
[item, ...] |
Obiekt |
Bieżący stan danego kierunku otwartego. |
openPercent |
Number |
Wymagane. Wskazuje odsetek otworzeń urządzenia, gdzie 0 jest zamknięte i 100 jest w pełni otwarte. |
openDirection |
String |
Wymagane. Kierunek, w którym urządzenie jest otwierane. Obsługiwane wartości:
|
Przykłady
Proste urządzenie zamykające.
{ "openPercent": 100 }
Otwórz urządzenie o 30% w dół i 50% w górę.
{ "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] }
Urządzenie CommandS
W ramach operacji EXECUTE
urządzenia z tą cechą mogą reagować na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.OpenClose
Ustaw stan zamknięcia urządzenia.
Parametry
Parametry | Typ | Opis |
---|---|---|
openPercent |
Number |
Wymagane. Wskazuje odsetek otworzeń urządzenia, gdzie 0 jest zamknięte i 100 jest w pełni otwarte. |
openDirection |
String |
Kierunek, w którym należy otworzyć plik. Atrybut występuje tylko wtedy, gdy urządzenie obsługuje wiele wskazówek dojazdu określonych przez atrybut Obsługiwane wartości:
|
followUpToken |
String |
Token udostępniony przez Google dla odpowiedzi uzupełniającej. |
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 zamknięcia podczas otwierania urządzenia wystąpił błąd.
Obsługiwane wartości:
lockedState
deviceJammingDetected
Dalsze odpowiedzi
W ramach operacji EXECUTE
urządzenia z tą cechą mogą zwrócić poniższy ładunek odpowiedzi. Więcej informacji o wdrażaniu dalszych odpowiedzi znajdziesz w artykule Powiadomienia dotyczące inteligentnych działań w domu.
Ładunek zawiera jedną z tych wartości:
Gotowe
Pola | Typ | Opis |
---|---|---|
followUpToken |
String |
Wymagane. Token podany w pierwotnym żądaniu EXECUTE. |
status |
String |
Wymagane. Wynik żądania. Obsługiwane wartości:
|
openPercent |
Number |
Wymagane. Wskazuje, ile procent urządzenia zostało otwarte, gdzie 0 zostało zamknięte, a 100 – w pełni otwarte. |
Niepowodzenie
Pola | Typ | Opis |
---|---|---|
followUpToken |
String |
Wymagane. Token podany w pierwotnym żądaniu EXECUTE. |
status |
String |
Wymagane. Wynik żądania. Obsługiwane wartości:
|
errorCode |
String |
Wymagane. Wartością może być kod błędu dla tej cechy, np. |
Przykłady
Otwórz bramę garażową. (dalsza odpowiedź w przypadku sukcesu)
{ "OpenClose": { "priority": 0, "followUpResponse": { "openPercent": 100, "status": "SUCCESS", "followUpToken": "1234" } } }
Otwórz bramę garażową. (dalsza odpowiedź w przypadku niepowodzenia)
{ "OpenClose": { "priority": 0, "followUpResponse": { "errorCode": "lockedState", "status": "FAILURE", "followUpToken": "1234" } } }
action.devices.commands.OpenCloseRelative
Dopasuj stan zamknięcia urządzenia do bieżącego stanu. To polecenie jest dostępne tylko wtedy, gdy commandOnlyOpenClose
ma wartość false
.
{ "commandOnlyOpenClose": false }
Parametry
Parametry | Typ | Opis |
---|---|---|
openRelativePercent |
Number |
Wymagane. Dokładny procent zmiany stanu zamknięcia. Duże polecenia względne będą przekształcane w parametry z dokładną wartością procentową (np. „Otwórz żaluzje trochę” zamiast „Otwórz rolety o 5%”). |
openDirection |
String |
Kierunek, w którym należy otworzyć plik. Atrybut występuje tylko wtedy, gdy urządzenie obsługuje wiele wskazówek dojazdu określonych przez atrybut Obsługiwane wartości:
|
Przykłady
Otwórz urządzenie trochę bardziej
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 5 } }
Wyłącz urządzenie o 10%
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": -10 } }
Otwórz urządzenie o 50% w dół.
{ "command": "action.devices.commands.OpenCloseRelative", "params": { "openRelativePercent": 50, "openDirection": "DOWN" } }
Powiązane błędy
Podczas ustawiania stanu zamknięcia podczas otwierania urządzenia wystąpił błąd.
Obsługiwane wartości:
lockedState
deviceJammingDetected
Przykładowe wypowiedzi
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%