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 trybu domu

action.devices.traits.Modes – ten atrybut obejmuje wszystkie dostępne tryby i ustawienia trybu urządzenia.

Ta cecha należy do każdego urządzenia z dowolną liczbą trybów „n-way”, w której tryby i ustawienia dla każdego z nich mogą być inne i niepowtarzalne dla każdego urządzenia lub typu urządzenia. Każdy tryb może mieć wiele ustawień, ale tylko jeden może być wybierany naraz. Suszarka nie może działać w trybie „delikatnym”, „normalnym” i „intensywnym” (jednocześnie). Ustawienie, które można łatwo włączyć lub wyłączyć, należy do kategorii Przełączniki.

Pralka może na przykład mieć ustawienia rozmiaru i temperatury wczytywania. Oba te tryby są niezależne od siebie, ale mogą występować tylko w jednym stanie. Użytkownik może ustawić tryb taki jak temperatura, używając polecenia takiego jak Ustaw temperaturę prania na zimno.

Niektóre tryby są „uporządkowane” i można je dostosowywać, zwiększając lub zmniejszając szczegółowość. Na przykład rozmiar obciążenia (mały, średni, duży) i temperatura są wyraźnie podane (uwaga: temperatura nie jest wartością termiczną z celem liczbowym, jak na innych urządzeniach), ale typ wczytywania (delikatne, normalne, wełna itp.) może nie być regulowany.

Ta cecha obejmuje co najmniej jeden tryb, który może skonfigurować użytkownik. Ogólnie tych trybów należy używać w przypadku funkcji, które nie są powiązane z innym zachowaniem 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
availableModes Tablica

Wymagany.

Lista dostępnych trybów.

[item, ...] Obiekt

Tryb dostępny.

name Ciąg

Wymagany.

Wewnętrzna nazwa trybu, 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 trybu w każdym obsługiwanym języku.

[item, ...] Obiekt

Synonimy trybu w danym języku.

name_synonym Tablica

Wymagany.

Synonimy trybu. 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.

settings Tablica

Wymagany.

Obsługiwane ustawienia tego trybu.

[item, ...] Obiekt

Obsługiwane ustawienie.

Wymagany jest co najmniej 2 elementy.

setting_name Ciąg

Wymagany.

Wewnętrzna nazwa ustawienia trybu, które będzie używane w poleceniach i stanach. Może nie być odpowiedni dla użytkowników i będzie dostępny we wszystkich językach.

setting_values Tablica

Wymagany.

Synonimy ustawienia w każdym obsługiwanym języku.

[item, ...] Obiekt

Synonimy ustawienia w danym języku.

setting_synonym Tablica

Wymagany.

Synonimy ustawienia. 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.

ordered Wartość logiczna

(domyślnie: false)

Jeśli zasada ma wartość Prawda, obowiązuje gramatyka dodatkowa w celu zwiększenia lub zmniejszania wartości w kolejności (rosnąco) tablicy ustawień.

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

queryOnlyModes 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 różnymi trybami i ustawieniami.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

Urządzenie w trybie poleceń.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

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
currentModeSettings Obiekt

Wymagany.

Para klucz-wartość korzysta z trybu name urządzenia jako klucza i bieżącej wartości setting_name jako wartości.

<string> Ciąg

Obecnie setting_name.

Przykłady

W jakim trybie jest urządzenie?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

Zaktualizuj ustawienia trybu.

Parametry

Parametry Typ Opis
updateModeSettings Obiekt

Wymagany.

Para klucz-wartość korzysta z trybu name urządzenia jako klucza i nowej wartości setting_name jako wartości.

<string> Ciąg

Nowy setting_name.

Przykłady

Ustaw duże obciążenie

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

Przykładowe wypowiedzi

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

Urządzenie ERRORS

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