Schemat cech przełączników inteligentnego domu

action.devices.traits.Toggles – ta cecha należy do wszystkich urządzeń, których ustawienia mogą mieć tylko jeden z 2 stanów.

Ustawienia te mogą reprezentować fizyczny przycisk w stanie włączonym/wyłączonym lub aktywnym/nieaktywnym, pole wyboru w HTML-u lub dowolny inny element, który można włączyć lub wyłączyć. Jeśli ustawienie ma więcej niż 2 stany lub ma stan, w którym nie jest wybrana żadna z opcji binarnych, lepiej jest przedstawić je jako cechę Modes, która odpowiada wielostanowym pokrętłom, przyciskom opcji (fizycznym lub HTML) lub stanom binarnym, które nie są wyraźnie włączone lub wyłączone (np. „AM/FM” lub „ciepło/zimno”).

Ta cecha obejmuje co najmniej 1 przełącznik, który użytkownicy mogą ustawić. Ogólnie rzecz biorąc, te przełączniki powinny być używane w przypadku funkcji, które nie są powiązane z innymi działaniami urządzenia. W przypadku powiązanych działań, takich jak włączanie i wyłączanie urządzenia, należy używać bardziej szczegółowych cech (np. thermostatMode w cechy TemperatureSetting).

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.

Przykłady

Urządzenie z wieloma przełącznikami.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

Urządzenie z przełącznikami tylko do poleceń.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

Urządzenie z przełącznikami tylko do zapytań.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

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.

Przykłady

Czy sterylizacja jest włączona?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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.SetToggles

Ustawianie danego stanu przełącznika.

Parametry

Przykłady

Włącz oszczędzanie energii.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

Wyłącz filtr.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

Przykładowe wypowiedzi

BŁĘDY urządzenia