Witamy w Google Home Developer Center – nowym miejscu, gdzie możesz dowiedzieć się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

Ta strona została przetłumaczona przez Cloud Translation API.

Schemat cech OpenClose Trait Smart Home

action.devices.traits.OpenClose – ta cecha należy do urządzeń, które obsługują otwieranie i zamykanie, a w niektórych przypadkach otwierają i zamykają częściowo lub potencjalnie w kilku kierunkach.

Urządzenia – ATTRIBUTES

Urządzenia z tą cechą mogą zgłaszać te problemy jako część operacji SYNC. Aby się uczyć więcej informacji o obsłudze intencji SYNC znajdziesz tutaj Realizacja intencji.

Atrybuty	Typ	Opis
`discreteOnlyOpenClose`	Wartość logiczna	(Domyślnie: `false`) Jeśli zasada ma wartość Prawda, urządzenie musi być całkowicie otwarte albo całkowicie zamknięte (nie obsługuje wartości od 0% do 100%).
`openDirection`	Tablica	Lista obsługiwanych kierunków, w których można otwierać i zamykać urządzenie. Dodaj ten atrybut, jeśli urządzenie umożliwia otwieranie i zamykanie w więcej niż jednym kierunku.
`[item, ...]`	String	Obsługiwany kierunek. Obsługiwane wartości: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`commandOnlyOpenClose`	Wartość logiczna	(Domyślnie: `false`) 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 reagować na intencję QUERY ani stan raportu dla tej cechy.
`queryOnlyOpenClose`	Wartość logiczna	(Domyślnie: `false`) Wskazuje, czy do urządzenia można wysyłać zapytania tylko o informacje o stanie i nie można nim sterować. Czujniki, które mogą zgłaszać tylko stan otwarcia, powinny mieć w tym polu wartość true (prawda).

Przykłady

Proste urządzenie typu open-close.

{
  "discreteOnlyOpenClose": true
}

Urządzenie z widokiem od dołu do góry. Można je otwierać w dowolnym kierunku.

{
  "openDirection": [
    "UP",
    "DOWN"
  ]
}

Urządzenie tylko na potrzeby poleceń.

{
  "commandOnlyOpenClose": false
}

Urządzenie STATES

Jednostki o tej cechie mogą zgłaszać: stanów w ramach operacji QUERY. Aby się uczyć więcej informacji o obsłudze intencji QUERY znajdziesz tutaj Realizacja intencji.

Ładunek zawiera jeden z następujących elementów:

Pojedynczy kierunek otwierający i zamykający

Stany Typ Opis

Stany	Typ	Opis
`openPercent`	Number	Wymagane. Wskazuje, w jakim stopniu urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 – w pełni otwarte.
`targetOpenPercent`	Number	Poziom wskazujący procent otwartych obszarów, do których trafi urządzenie lub do którego będzie się przemieszczać w wyniku trwającej zmiany pozycji.

openPercent

Number

Wymagane.

Wskazuje, w jakim stopniu urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 – w pełni otwarte.

targetOpenPercent

Number

Poziom wskazujący procent otwartych obszarów, do których trafi urządzenie lub do którego będzie się przemieszczać w wyniku trwającej zmiany pozycji.

Otwieranie i zamykanie w różnych kierunkach

Stany	Typ	Opis
`openState`	Tablica	Wymagane. Lista stanów każdego obsługiwanego kierunku otwartego.
`[item, ...]`	Obiekt.	Bieżący stan danego kierunku otwartego.
`openPercent`	Number	Wymagane. Wskazuje, w jakim stopniu urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 – w pełni otwarte.
`targetOpenPercent`	Number	Poziom wskazujący procent otwartych obszarów, do których trafi urządzenie lub do którego będzie się przemieszczać w wyniku trwającej zmiany pozycji.
`openDirection`	String	Wymagane. Kierunek, w którym urządzenie jest otwierane. Obsługiwane wartości: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

Przykłady

Proste urządzenie typu open-close.

{
  "openPercent": 100
}

Proste urządzenie z otwartym i zamknięciem, które otwiera się w nowej pozycji.

{
  "openPercent": 50,
  "targetOpenPercent": 100
}

Otwórz urządzenie o 30% w kierunku w dół i o 50% w kierunku do góry.

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "openDirection": "UP"
    }
  ]
}

Otwórz urządzenie o 30% w kierunku do dołu i o 50% w górę (obecnie w 80% w kierunku góry).

{
  "openState": [
    {
      "openPercent": 30,
      "openDirection": "DOWN"
    },
    {
      "openPercent": 50,
      "targetOpenPercent": 80,
      "openDirection": "UP"
    }
  ]
}

Polecenia na urządzeniu

Urządzenia z tą cechą mogą reagować na: w ramach operacji EXECUTE. Aby się uczyć więcej informacji o obsłudze intencji EXECUTE znajdziesz tutaj Realizacja intencji.

`action.devices.commands.OpenClose`

Ustaw stan otwarcia i zamknięcia urządzenia.

Parametry

Parametry Typ Opis

Parametry	Typ	Opis
`openPercent`	Number	Wymagane. Wskazuje, w jakim stopniu urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 – w pełni otwarte.
`openDirection`	String	Kierunek, w którym ma zostać otworzony. Widoczny tylko wtedy, gdy urządzenie obsługuje wiele kierunków (wskazuje to w atrybucie `openDirection`), a kierunek został określony przez użytkownika. Obsługiwane wartości: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`
`followUpToken`	String	Token dostarczony przez Google na potrzeby dalszych odpowiedzi.

openPercent

Number

Wymagane.

Wskazuje, w jakim stopniu urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 – w pełni otwarte.

openDirection

String

Kierunek, w którym ma zostać otworzony. Widoczny tylko wtedy, gdy urządzenie obsługuje wiele kierunków (wskazuje to w atrybucie openDirection), a kierunek został określony przez użytkownika.

Obsługiwane wartości:

UP
DOWN
LEFT
RIGHT
IN
OUT

followUpToken

String

Token dostarczony przez Google na potrzeby dalszych odpowiedzi.

Przykłady

Otwórz urządzenie.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 100,
    "followUpToken": "123"
  }
}

Otwórz urządzenie w 50 procentach.

{
  "command": "action.devices.commands.OpenClose",
  "params": {
    "openPercent": 50,
    "openDirection": "DOWN",
    "followUpToken": "456"
  }
}

Podczas ustawiania stanu otwarcia i zamknięcia urządzenia wystąpił błąd.

Obsługiwane wartości:

lockedState
deviceJammingDetected

Dalsze odpowiedzi

Urządzenia z tą cechą mogą zwracać te wartości: ładunku kolejnej odpowiedzi w ramach operacji EXECUTE. Aby się uczyć więcej o wdrażaniu kolejnych odpowiedzi, zobacz Powiadomienia dotyczące działań inteligentnego domu.

Ładunek zawiera jeden z następujących elementów:

Sukces

Pola Typ Opis

Pola	Typ	Opis
`followUpToken`	String	Wymagane. Token podany w pierwotnym żądaniu EXECUTE.
`status`	String	Wymagane. Rezultat żądania. Obsługiwane wartości: `SUCCESS`
`openPercent`	Number	Wymagane. Wskazuje, czy urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 w pełni otwarte.

followUpToken

String

Wymagane.

Token podany w pierwotnym żądaniu EXECUTE.

status

String

Wymagane.

Rezultat żądania.

Obsługiwane wartości:

SUCCESS

openPercent

Number

Wymagane.

Wskazuje, czy urządzenie jest otwarte, gdzie 0 jest zamknięte, a 100 w pełni otwarte.

Niepowodzenie

Pola Typ Opis

Pola	Typ	Opis
`followUpToken`	String	Wymagane. Token podany w pierwotnym żądaniu EXECUTE.
`status`	String	Wymagane. Rezultat żądania. Obsługiwane wartości: `FAILURE`
`errorCode`	String	Wymagane. Wartością może być dowolny kod błędu tej cechy, na przykład `lockedState`.

followUpToken

String

Wymagane.

Token podany w pierwotnym żądaniu EXECUTE.

status

String

Wymagane.

Rezultat żądania.

Obsługiwane wartości:

FAILURE

errorCode

String

Wymagane.

Wartością może być dowolny kod błędu tej cechy, na przykład lockedState.

Przykłady

Otwórz bramę garażową. (odpowiedź w przypadku powodzenia)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "openPercent": 100,
      "status": "SUCCESS",
      "followUpToken": "1234"
    }
  }
}

Otwórz bramę garażową. (odpowiedź w przypadku niepowodzenia)

{
  "OpenClose": {
    "priority": 0,
    "followUpResponse": {
      "errorCode": "lockedState",
      "status": "FAILURE",
      "followUpToken": "1234"
    }
  }
}

`action.devices.commands.OpenCloseRelative`

Dostosuj stan urządzenia (otwarcie i zamknięcie) w odniesieniu do bieżącego stanu. To polecenie jest dostępne tylko wtedy, gdy commandOnlyOpenClose ma wartość false.

To polecenie wymaga następujących atrybutów:

{
  "commandOnlyOpenClose": false
}

Parametry

Parametry Typ Opis

Parametry	Typ	Opis
`openRelativePercent`	Number	Wymagane. Dokładna wartość procentowa zmiany stanu otwarcia i zamknięcia. Niejednoznaczne polecenia względne zostaną przekonwertowane na dokładny parametr wartości procentowych (np. „Otwórz jeszcze bardziej rolety” lub „Otwórz rolety o 5%”).
`openDirection`	String	Kierunek, w którym ma zostać otworzony. Widoczny tylko wtedy, gdy urządzenie obsługuje wiele kierunków (wskazuje to w atrybucie `openDirection`), a kierunek został określony przez użytkownika. Obsługiwane wartości: `UP` `DOWN` `LEFT` `RIGHT` `IN` `OUT`

openRelativePercent

Number

Wymagane.

Dokładna wartość procentowa zmiany stanu otwarcia i zamknięcia. Niejednoznaczne polecenia względne zostaną przekonwertowane na dokładny parametr wartości procentowych (np. „Otwórz jeszcze bardziej rolety” lub „Otwórz rolety o 5%”).

openDirection

String

Obsługiwane wartości:

UP
DOWN
LEFT
RIGHT
IN
OUT

Przykłady

Ponownie otwórz urządzenie.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 5
  }
}

Zamknij urządzenie o 10% dłużej

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": -10
  }
}

Otwieraj urządzenie o 50% więcej, w dół.

{
  "command": "action.devices.commands.OpenCloseRelative",
  "params": {
    "openRelativePercent": 50,
    "openDirection": "DOWN"
  }
}

Podczas ustawiania stanu otwarcia i zamknięcia 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%

Urządzenie ERRORS

Zobacz pełną listę błędów i wyjątków.

Schemat cech OpenClose Trait Smart Home

Urządzenia – ATTRIBUTES

Przykłady

Urządzenie STATES

Pojedynczy kierunek otwierający i zamykający

Otwieranie i zamykanie w różnych kierunkach

Przykłady

Polecenia na urządzeniu

action.devices.commands.OpenClose

Parametry

Przykłady

Powiązane błędy

Dalsze odpowiedzi

Sukces

Niepowodzenie

Przykłady

action.devices.commands.OpenCloseRelative

Parametry

Przykłady

Powiązane błędy

Przykładowe wypowiedzi

de-DE

en-US

es-ES

fr-FR

hi-IN

it-IT

ja-JP

ko-KR

nl-NL

pt-BR

sv-SE

Urządzenie ERRORS

`action.devices.commands.OpenClose`

`action.devices.commands.OpenCloseRelative`