Inteligentny dom przełącza schemat trait

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

Ustawienia te mogą reprezentować przycisk fizyczny ze stanem „wł./wył.” lub „aktywny/nieaktywny”, pole wyboru w kodzie HTML lub dowolny inny rodzaj wyraźnie aktywnego/wyłączonego elementu. Jeśli ustawienie ma więcej niż 2 stany lub stan, w którym żadna z opcji binarnych nie jest wybrana, lepiej to przedstawić jako cechę Modes, co oznacza tarczę wielostanową, przyciski radiowe (fizyczne lub HTML) lub stany binarne, które nie są wyraźnie włączone/wyłączone (np. „AM/FM” lub „zimne”).

Ta cecha obejmuje 1 lub więcej indywidualnych przełączników, które użytkownik może ustawić. Ogólnie przełączniki te powinny być używane w przypadku funkcji, które nie są powiązane z innym działaniem urządzenia. Powiązane zachowania, takie jak włączanie lub wyłączanie urządzenia, powinny wykorzystywać bardziej konkretne cechy (na przykład thermostatMode w cechu TemperatureSetting).

Urządzenie ATTRIBUTES

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

Atrybuty	Typ	Opis
availableToggles	Tablica	Wymagane. Lista dostępnych przełączników.
[item, ...]	Obiekt	Przełącznik dostępnych.
name	String	Wymagane. Wewnętrzna nazwa przełącznika, która będzie używana w poleceniach i stanach. Tekst ten może nie być przyjazny dla użytkownika i będzie udostępniany we wszystkich językach.
name_values	Tablica	Wymagane. Synonimy przełącznika w poszczególnych obsługiwanych językach.
[item, ...]	Obiekt	Synonimy przełącznika w danym języku.
name_synonym	Tablica	Wymagane. Synonimy przełącznika. Pierwszy ciąg znaków na liście jest używany jako nazwa kanoniczna 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) Określa, 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 odpowiedzieć na intencję QUERY lub stan raportu w przypadku tej cechy.
queryOnlyToggles	Wartość logiczna	(Domyślnie: false) Wymagane, jeśli urządzenie obsługuje tylko wykonywanie zapytań. Ten atrybut wskazuje, czy urządzenie może być wywoływane tylko przez informacje o stanie i nie może nim sterować.

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 umożliwiającymi tylko wykonywanie poleceń.

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

Urządzenie z przełącznikami typu „tylko zapytanie”.

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

Urządzenie STATES

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

Stany	Typ	Opis
currentToggleSettings	Obiekt	Wymagane. Para klucz/wartość z przełącznikiem name urządzenia jako kluczem, a bieżący stan jako wartością.
<string>	Wartość logiczna	Obecny stan przełączania.

Przykłady

Czy sterylizacja jest włączona?

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

CommandS na urządzeniu

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

action.devices.commands.SetToggles

Ustaw dany stan przełączania.

Parametry

Parametry	Typ	Opis
updateToggleSettings	Obiekt	Wymagane. Para klucz/wartość z przełącznikiem name urządzenia jako kluczem, a nowy stan 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.