Schemat cechy Smart Home OpenClose

action.devices.traits.OpenClose – ta cecha należy do urządzeń, które obsługują otwieranie i zamykanie, a w niektórych przypadkach także częściowe otwieranie i zamykanie lub otwieranie i zamykanie w więcej niż jednym kierunku.

Atrybuty urządzenia

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

Atrybuty Typ Opis
discreteOnlyOpenClose Wartość logiczna

(Domyślnie: false)

Jeśli wartość to „true”, oznacza to, że urządzenie musi być całkowicie otwarte lub całkowicie zamknięte (nie obsługuje wartości z zakresu od 0% do 100%).
openDirection Tablica

Lista obsługiwanych kierunków, w których urządzenie może się otwierać lub zamykać. Dodaj ten atrybut, jeśli urządzenie można otwierać i zamykać 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 „true”, jeśli urządzenie nie może odpowiadać na intencję QUERY ani zgłaszać stanu w przypadku tej cechy.
queryOnlyOpenClose Wartość logiczna

(Domyślnie: false)

Wskazuje, czy urządzenie może być używane tylko do sprawdzania informacji o stanie, a nie do sterowania. Czujniki, które mogą zgłaszać tylko stan otwarty, powinny ustawić to pole na wartość „true”.

Przykłady

Proste urządzenie do otwierania i zamykania.

{
  "discreteOnlyOpenClose": true
}

Urządzenie z możliwością otwierania od góry i od dołu. Można je otwierać w dowolnym kierunku.

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

Urządzenie obsługujące tylko polecenia.

{
  "commandOnlyOpenClose": false
}

Stany urządzenia

Elementy z tym atrybutem mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze QUERY intencji znajdziesz w artykule Realizacja intencji.

Ładunek zawiera jedną z tych wartości:

Otwieranie i zamykanie w jednym kierunku

Stany Typ Opis
openPercent Number

Wymagany.

Wskazuje procent otwarcia urządzenia, gdzie 0 oznacza zamknięcie, a 100 – pełne otwarcie.
targetOpenPercent Number

Poziom wskazujący procent otwarcia, do którego 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

Wymagany.

Lista stanów dla każdego obsługiwanego kierunku otwarcia.
[item, ...] Obiekt

Bieżący stan dla danego kierunku otwarcia.
openPercent Number

Wymagany.

Wskazuje procent otwarcia urządzenia, gdzie 0 oznacza zamknięcie, a 100 – pełne otwarcie.
targetOpenPercent Number

Poziom wskazujący procent otwarcia, do którego urządzenie przejdzie lub do którego się przesuwa w wyniku trwającej zmiany pozycji.
openDirection String

Wymagany.

Kierunek, w którym urządzenie jest otwierane.

Obsługiwane wartości:

UP
DOWN
LEFT
RIGHT
IN
OUT

Przykłady

Proste urządzenie do otwierania i zamykania.

{
  "openPercent": 100
}

Proste urządzenie otwierane i zamykane, 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 otwieram je o 80% w górę.

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

Polecenia dotyczące urządzenia

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

action.devices.commands.OpenClose

Ustaw stan otwarcia i zamknięcia urządzenia.

Parametry

Parametry Typ Opis
openPercent Number

Wymagany.

Wskazuje procent otwarcia urządzenia, gdzie 0 oznacza zamknięcie, a 100 – pełne otwarcie.
openDirection String

Kierunek otwierania. Występuje tylko wtedy, gdy urządzenie obsługuje wiele kierunków, co jest wskazane przez atrybut openDirection, a kierunek jest określony przez użytkownika.

Obsługiwane wartości:

UP
DOWN
LEFT
RIGHT
IN
OUT
followUpToken String

Token dostarczony przez Google do 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 50% w dół.

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

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

Obsługiwane wartości:

lockedState
deviceJammingDetected

Odpowiedzi uzupełniające

Urządzenia z tą cechą mogą zwracać ten ładunek odpowiedzi uzupełniającej w ramach operacji EXECUTE. Więcej informacji o wdrażaniu odpowiedzi uzupełniających znajdziesz w artykule Powiadomienia dotyczące działań związanych z inteligentnym domem.

Ładunek zawiera jedną z tych wartości:

Sukces

Pola Typ Opis
followUpToken String

Wymagany.

Token podany w pierwotnym żądaniu EXECUTE.
status String

Wymagany.

Wynik żądania.

Obsługiwane wartości:

SUCCESS
openPercent Number

Wymagany.

Wskazuje procent otwarcia urządzenia, gdzie 0 oznacza zamknięcie, a 100 – pełne otwarcie.

Niepowodzenie

Pola Typ Opis
followUpToken String

Wymagany.

Token podany w pierwotnym żądaniu EXECUTE.
status String

Wymagany.

Wynik żądania.

Obsługiwane wartości:

FAILURE
errorCode String

Wymagany.

Wartość może być dowolnym kodem błędu dla tego atrybutu, np. lockedState.

Przykłady

Otwórz bramę garażową. (follow-up response for success case)

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

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

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

action.devices.commands.OpenCloseRelative

Dostosuj stan otwarcia i zamknięcia urządzenia względem bieżącego stanu. To polecenie jest dostępne tylko wtedy, gdy element discreteOnlyOpenClose ma wartość false.

To polecenie wymaga tych atrybutów: 
{
  "discreteOnlyOpenClose": false
}

Parametry

Parametry Typ Opis
openRelativePercent Number

Wymagany.

Dokładny procent zmiany stanu otwarcia lub zamknięcia. Niejednoznaczne polecenia względne zostaną przekształcone w dokładny parametr procentowy (np. „Otwórz rolety trochę bardziej” zamiast „Otwórz rolety o 5%”).
openDirection String

Kierunek otwierania. Występuje tylko wtedy, gdy urządzenie obsługuje wiele kierunków, co jest wskazane przez atrybut openDirection, a kierunek jest określony przez użytkownika.

Obsługiwane wartości:

UP
DOWN
LEFT
RIGHT
IN
OUT

Przykłady

Otwórz urządzenie nieco szerzej

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

Zamknij urządzenie o 10% bardziej

{
  "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"
  }
}

Podczas ustawiania stanu otwarcia lub 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%

BŁĘDY urządzenia

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