Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Schemat inteligentnego przełącznika domu

action.devices.traits.Toggles – ten atrybut należy do każdego urządzenia, którego ustawienia mogą istnieć tylko w jednym z 2 stanów.

Ustawienia te mogą reprezentować fizyczny przycisk ze stanem włączenia/wyłączenia, stanem aktywnym lub nieaktywnym, polem wyboru w kodzie HTML lub dowolnym innym elementem, który jest wyraźnie włączony lub wyłączony. Jeśli ustawienie zawiera więcej niż 2 stany lub ma stan, w którym nie wybrano żadnej z opcji binarnych, lepiej jest określić go za pomocą opcji Tryby, która odpowiada skrótom wielostanowym, przyciskom radiowym (fizycznym lub HTML) bądź stanom binarnym, które nie są jednoznacznie włączone/wyłączone (np. „AM/FM” lub „gorące/zimne”).

Ta cecha obejmuje co najmniej jeden przełącznik, który użytkownicy mogą ustawić. Ogólnie przełączniki powinny służyć do obsługi funkcji, które nie są powiązane z innym działaniem urządzenia. Połączone zachowanie, na przykład włączanie i wyłączanie urządzenia, powinno korzystać z bardziej szczegółowych cech (np. thermostatMode w typie TemperatureSetting).

ATRYBUTY urządzenia

W ramach operacji SYNC urządzenia z tą cechą mogą zgłaszać wymienione poniżej atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w sekcji Realizacja intencji.

Atrybuty Typ Opis
availableToggles Tablica

Wymagany.

Lista dostępnych przełączników.

[item, ...] Obiekt

Przełącznik jest dostępny.

name Ciąg

Wymagany.

Wewnętrzna nazwa przełącznika, która będzie używana w poleceniach i stanach. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach.

name_values Tablica

Wymagany.

Synonimy przełącznika w każdym obsługiwanym języku.

[item, ...] Obiekt

Synonimy przełącznika w danym języku.

name_synonym Tablica

Wymagany.

Synonimy przełącznika. Pierwszy ciąg znaków z tej listy jest używany jako kanoniczna nazwa poziomu w danym języku.

[item, ...] Ciąg

Nazwa synonimu.

lang Ciąg

Wymagany.

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 odpowiedzieć na intencję QUERY lub stan raportu w przypadku tego atrybutu.

queryOnlyToggles Wartość logiczna

(domyślnie: false)

Wymagane, jeśli urządzenie obsługuje wykonywanie tylko zapytań. Ten atrybut wskazuje, że do urządzenia można wysyłać zapytania tylko o informacje 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 poleceń.

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

Urządzenie z przełącznikami umożliwiającymi tylko wyświetlanie zapytań.

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

Urządzenie STATES

W ramach operacji QUERY encje o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w sekcji Realizacja intencji.

Stany Typ Opis
currentToggleSettings Obiekt

Wymagany.

Para klucz/wartość używa przełącznika name urządzenia jako klucza i obecnego stanu 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
  }
}

Polecenie urządzenia

W ramach operacji EXECUTE urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE znajdziesz w sekcji Realizacja intencji.

action.devices.commands.SetToggles

Ustaw dany stan przełącznika.

Parametry

Parametry Typ Opis
updateToggleSettings Obiekt

Wymagany.

Para klucz-wartość zawiera przełącznik name urządzenia jako klucz i nowy stan jako wartość.

<string> Wartość logiczna

Nowy stan przełącznika

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 frysen

Urządzenie ERRORS

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