Inteligentny dom przełącza schemat cech

action.devices.traits.Toggles – ta cecha należy do wszystkich urządzeń z ustawieniami, które mogą istnieć tylko w jednym z 2 stanów.

Te ustawienia mogą reprezentować przycisk z włączonym/wyłączonym lub aktywnym bądź nieaktywnym stan, pole wyboru w kodzie HTML i jakiekolwiek inne elementy, . Jeśli ustawienie ma więcej niż 2 stany lub zawiera stan nie jest wybrana żadna opcja binarna, lepiej jest ona przedstawiona jako Cecha Modes, która odpowiada telefonom z różnych stanów. (fizycznych lub HTML) albo stanów binarnych, które nie są jednoznacznie włącz/wyłącz (np. „AM/FM” lub „gorąco/zimno”).

Ta cecha obejmuje co najmniej 1 pojedynczy przełącznik, który użytkownicy mogą ustawić. W należy używać tych przełączników w przypadku funkcji, które są odłączone z innego zachowania urządzenia. powiązane zachowania, takie jak włączanie samego urządzenia; włączony lub wyłączony, powinien używać bardziej szczegółowych cech (np. thermostatMode ma cechę TemperatureSetting).

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
availableToggles	Tablica	Wymagane. Lista dostępnych przełączników.
[item, ...]	Obiekt.	Dostępny przełącznik.
name	String	Wymagane. Wewnętrzna nazwa przełącznika, która będzie używana w poleceniach i stanach. Może być on nieprzyjazny dla użytkownika i będzie udostępniany we wszystkich językach.
name_values	Tablica	Wymagane. Synonimy przełącznika w każdym obsługiwanym języku.
[item, ...]	Obiekt.	Synonimy przełącznika w danym języku.
name_synonym	Tablica	Wymagane. Synonimy przełącznika. Pierwszy ciąg na liście jest używany jako kanoniczna nazwa poziomu w danym języku.
[item, ...]	String	Nazwa synonimu.
lang	String	Wymagane. Kod języka (ISO 639-1). Zobacz obsługiwane języki.
commandOnlyToggles	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.
queryOnlyToggles	Wartość logiczna	(Domyślnie: false) Wymagane, jeśli urządzenie obsługuje tylko wykonywanie zapytań. Ten atrybut wskazuje, że do urządzenia można wysyłać zapytania tylko w celu uzyskania informacji o stanie i nie można nim sterować.

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 w trybie „tylko polecenia”.

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

Urządzenie z przełącznikami dotyczącymi tylko zapytania.

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

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.

Stany	Typ	Opis
currentToggleSettings	Obiekt.	Wymagane. Para klucz-wartość z przełącznikiem name urządzenia jako kluczem i obecnym stanem jako wartością.
<string>	Wartość logiczna	Bieżący stan przełącznika.

Przykłady

Czy sterylizacja jest włączona?

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

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

Ustaw określony stan przełącznika.

Parametry

Parametry	Typ	Opis
updateToggleSettings	Obiekt.	Wymagane. Para klucz-wartość z przełącznikiem name urządzenia jako kluczem i nowym stanem jako wartością.
<string>	Wartość logiczna	Nowy stan przełączania

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

de-DE

• Bitte schalte Power Cool am Kühlschrank aus
• stelle den Kühlschrank auf Power Cool

en-US

• activate power freeze for the freezer
• cancel power cool for the kitchen fridge

es-ES

• pon el enfriamiento rápido en la nevera
• quita el enfriamiento rápido

fr-FR

• mets le mode power cool sur le réfrigérateur
• Éteins le mode power freeze du réfrigérateur .

hi-IN

• रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
• रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

• disattiva il power freeze del freezer
• imposta la funzione power freeze del surgelatore

ja-JP

• 冷蔵庫 の 急速冷凍 つけて
• 冷蔵庫 の 急速冷凍 を切ってくれる

ko-KR

• 냉장고 급속 냉장 해제해
• 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

• Zet de power cool uit op de koelkast
• zet de koelkast op superkoelen

pt-BR

• Ativa a função power freeze no congelador .
• Desativa o bloqueio infantil do forno .
• desligar o power cool da geladeira
• iniciar o modo power freeze do freezer

sv-SE

• Stäng av power cool i kylskåpet
• sätt på power freeze på frysen

Urządzenie ERRORS

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