Schemat atrybutu przełącznika w inteligentnym domu

action.devices.traits.Toggles – ta cecha dotyczy wszystkich urządzeń z ustawieniami, które mogą mieć tylko jeden z 2 stanów.

Te ustawienia mogą reprezentować przycisk fizyczny z poziomem włączenia/wyłączenia lub aktywny/nieaktywny stan, pole wyboru w HTML lub dowolny inny element, który można włączyć lub wyłączyć. Jeśli ustawienie ma więcej niż 2 stany lub stan, w którym żadna z opcji binarnych nie jest wybrana, lepiej reprezentować je za pomocą atrybutu Modes, który odpowiada elementom wielostanowym, przyciskom radiowym (fizycznym lub HTML) lub stanom binarnym, które nie są wyraźnie włączone/wyłączone (np. „AM/FM” lub „gorąco/zimno”).

Ta cecha obejmuje co najmniej 1 przełącznik, który użytkownicy mogą ustawiać. Ogólnie te przełączniki powinny być używane w przypadku funkcji, które nie są powiązane z działaniem innych urządzeń. Powiązane zachowania, takie jak włączanie i wyłączanie urządzenia, powinny używać bardziej szczegółowych atrybutów (np. thermostatMode w atrybucie TemperatureSetting).

ATRYBUTY URZĄDZENIA

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

Przykłady

Urządzenie z kilkoma 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 sterowania poleceniami.

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

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Przykłady

Czy sterylizacja jest włączona?

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

Polecenia urządzenia

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

action.devices.commands.SetToggles

Ustaw dany stan 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