Schemat trait systemu 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 otwieranie i zamykanie części lub potencjalnie w kilku kierunkach.

Uwaga: w przypadku tej cechy należy użyć weryfikacji użytkownika dodatkowego.

ATTRIBUTES urządzenia

Urządzenia z tą cechą mogą w ramach operacji SYNC zgłaszać te atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule o realizacji intencji.

Atrybuty	Typ	Opis
discreteOnlyOpenClose	Wartość logiczna	(Domyślnie: false) Jeśli zasada ma wartość prawda, urządzenie musi być w pełni otwarte lub całkowicie zamknięte (nie obsługuje wartości z zakresu od 0% do 100%).
openDirection	Tablica	Lista obsługiwanych instrukcji, które pozwalają otworzyć lub zamknąć urządzenie. Dodaj 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: UP DOWN LEFT RIGHT IN OUT
commandOnlyOpenClose	Wartość logiczna	(Domyślnie: false) Określa, czy urządzenie obsługuje komunikację jednokierunkową (prawda) czy dwukierunkową (fałsz). Ustaw ten atrybut na wartość prawda, jeśli urządzenie nie może odpowiedzieć na intencję QUERY lub na stan raportu w przypadku tej cechy.
queryOnlyOpenClose	Wartość logiczna	(Domyślnie: false) Wskazuje, czy urządzeniem można wysyłać zapytania tylko o informacje o stanie i nie można nim sterować. Czujniki, które mogą raportować tylko stan otwarty, powinny ustawić to pole na wartość prawda.

Przykłady

Proste urządzenie typu open-close.

{
  "discreteOnlyOpenClose": true
}

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

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

Urządzenie z dostępem tylko do poleceń.

{
  "commandOnlyOpenClose": false
}

Urządzenie STATES

Encje z tą cechą mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule o realizacji intencji.

Ładunek zawiera jeden z tych elementów:

Otwieranie i zamykanie w jednym kierunku

Stany	Typ	Opis
openPercent	Number	Wymagane. Wskazuje odsetek otwartego urządzenia, przy czym 0 jest zamknięte, a 100 – w pełni otwarte.
targetOpenPercent	Number	Poziom wskazujący procent otwartych punktów, do których urządzenie przejdzie lub do którego się przesuwa w wyniku trwającej zmiany pozycji.

Otwieranie i zamykanie w wielu kierunkach

Stany	Typ	Opis
openState	Tablica	Wymagane. Lista stanów dla każdego obsługiwanego kierunku otwarcia.
[item, ...]	Obiekt.	Bieżący stan danego kierunku otwarcia.
openPercent	Number	Wymagane. Wskazuje odsetek otwartego urządzenia, przy czym 0 jest zamknięte, a 100 – w pełni otwarte.
targetOpenPercent	Number	Poziom wskazujący procent otwartych punktów, do których urządzenie przejdzie lub do którego się przesuwa w wyniku trwającej zmiany pozycji.
openDirection	String	Wymagane. Kierunek otwierania urządzenia. Obsługiwane wartości: UP DOWN LEFT RIGHT IN OUT

Przykłady

Proste urządzenie typu open-close.

{
  "openPercent": 100
}

Proste urządzenie typu open-close, które obecnie otwiera się w nowej pozycji.

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

Otwórz urządzenie o 30% w dół i o 50% w górę.

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

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

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

POLECENIA urządzenia

Uwaga: ta cecha umożliwia podanie dodatkowego stanu z dodatkową odpowiedzią na prośbę o weryfikację użytkownika. Więcej informacji znajdziesz w sekcji Obsługiwane typy testów zabezpieczających.

Urządzenia z tą cechą mogą reagować na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w artykule o realizacji intencji.

action.devices.commands.OpenClose

Ustaw stan zamknięcia urządzenia.

Parametry

Parametry	Typ	Opis
openPercent	Number	Wymagane. Wskazuje odsetek otwartego urządzenia, przy czym 0 jest zamknięte, a 100 – w pełni otwarte.
openDirection	String	Kierunek otwierania. Widoczny tylko wtedy, gdy urządzenie obsługuje wiele kierunków wskazanych w atrybucie openDirection, a kierunek został określony przez użytkownika. Obsługiwane wartości: UP DOWN LEFT RIGHT IN OUT
followUpToken	String	Dostarczony przez Google token odpowiedzi.

Przykłady

Otwórz urządzenie.

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

Otwórz urządzenie w 50 procentach z góry.

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

Powiązane błędy

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

Obsługiwane wartości:

lockedState

deviceJammingDetected

Dalsze odpowiedzi

Urządzenia z tą cechą mogą w ramach operacji EXECUTE zwracać następujący ładunek odpowiedzi. Więcej informacji o implementowaniu dalszych odpowiedzi znajdziesz w artykule Powiadomienia dotyczące działań w inteligentnym domu.

Ładunek zawiera jeden z tych elementów:

Gotowe

Pola	Typ	Opis
followUpToken	String	Wymagane. Token podany w pierwotnym żądaniu EXECUTE.
status	String	Wymagane. Wynik żądania. Obsługiwane wartości: SUCCESS
openPercent	Number	Wymagane. Wskazuje odsetek otwartego urządzenia, przy czym 0 jest 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: FAILURE
errorCode	String	Wymagane. Wartością może być dowolny kod błędu dla tej cechy, np. lockedState.

Przykłady

Otwórz drzwi garażowe. (dalsza odpowiedź w przypadku zgłoszenia sukcesu).

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

Otwórz drzwi garażowe. (dodatkowa odpowiedź w przypadku niepowodzenia)

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

action.devices.commands.OpenCloseRelative

Dostosuj stan otwarcia urządzenia do bieżącego stanu. To polecenie jest dostępne tylko wtedy, gdy commandOnlyOpenClose ma wartość false.

To polecenie wymaga tych atrybutów:

{
  "commandOnlyOpenClose": false
}

Parametry

Parametry	Typ	Opis
openRelativePercent	Number	Wymagane. Dokładna wartość procentowa zmiany stanu otwarcia/zamknięcia. Polecenia względne będą konwertowane na dokładny parametr procentowy (np. „Otwórz rolety trochę bardziej” lub „Otwórz rolety o 5%”).
openDirection	String	Kierunek otwierania. Widoczny tylko wtedy, gdy urządzenie obsługuje wiele kierunków wskazanych w atrybucie openDirection, a kierunek został określony przez użytkownika. Obsługiwane wartości: UP DOWN LEFT RIGHT IN OUT

Przykłady

Jeszcze trochę otwórz urządzenie

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

Zamknij urządzenie o 10% więcej

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

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

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

Powiązane błędy

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

Obsługiwane wartości:

lockedState

deviceJammingDetected

Przykładowe wypowiedzi

To jest próbka wyrażeń obsługiwanych przez tę cechę urządzenia. Zapoznaj się też z innymi obsługiwanymi językami.

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%

ERRORS urządzenia

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