Witamy w Google Home Developer Center – nowym miejscu, gdzie możesz dowiedzieć się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

Schemat zadania inteligentnego wypełniania ekranu głównego

action.devices.traits.Fill – tę cechę stosuje się na urządzeniach obsługujących wypełnianie, np. w wannie.

ATTRIBUTES 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
availableFillLevels Obiekt

Opisuje różne poziomy wypełnienia urządzenia.

levels Tablica

Wymagane.

Lista nazw poziomów i synonimów specyficznych dla danego języka.

[item, ...] Obiekt

Nazwa poziomu i jego synonimy.

level_name Ciąg

Wymagane.

Wewnętrzna nazwa poziomu. Może nie być przyjazna dla użytkownika i będzie dostępna we wszystkich językach.

level_values Tablica

Wymagane.

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

[item, ...] Obiekt

Synonimy poziomu w danym języku.

level_synonym Tablica

Wymagane.

Synonim poziomu. Pierwszy ciąg znaków z tej listy jest używany jako kanoniczna nazwa poziomu w tym języku.

[item, ...] Ciąg

Nazwa synonimu.

lang Ciąg

Wymagane.

Kod języka (ISO 639-1). Zobacz obsługiwane języki.

ordered Wartość logiczna

Wymagane.

Jeśli zasada ma wartość Prawda, urządzenie obsługuje dodatkowe gramatyki, aby zwiększać lub zmniejszać wartość w postaci tablicy levels (np. połowy poziomu).

supportsFillPercent Wartość logiczna

(Domyślnie: false)

Jeśli ma wartość Prawda, zaakceptuj polecenia, aby dostosowywać poziom do wartości procentowej.

Przykłady

Urządzenie z podstawowymi możliwościami wypełniania lub opróżniania nieobsługujące określonych poziomów wypełnienia.

{}

Urządzenie obsługujące konkretny poziom wypełnienia.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

Urządzenie STATES

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

Stany Typ Opis
isFilled Wartość logiczna

Wymagane.

Wartość to „prawda”, jeśli urządzenie jest wypełnione na dowolnym poziomie. Wartość fałsz, jeśli urządzenie jest całkowicie opróżnione.

currentFillLevel Ciąg

Wymagane, jeśli ustawiono atrybut availableFillLevels. Wskazuje aktualną wartość level_name z atrybutu availableFillLevels, przy którym jest wypełniane urządzenie.

currentFillPercent Number

Wymagane, jeśli ustawiono atrybut supportsFillPercent. Wskazuje bieżący procent wypełnienia.

Przykłady

Czy wanna jest pełna?

{
  "isFilled": true
}

Czy wanna jest pełna? (z poziomami).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

Urządzenie CommandS

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

action.devices.commands.Fill

Napełnij lub opróżnij urządzenie.

Parametry

Parametry Typ Opis
fill Wartość logiczna

Wymagane.

Prawda, aby wypełnić – Fałsz – opróżniam.

fillLevel Ciąg

Wskazuje level_name z atrybutu availableFillLevels do ustawienia. Jeśli nie określisz poziomu, wypełnij go na poziomie domyślnym.

fillPercent Number

Wskazuje żądany poziom procentowy.

Przykłady

Napełnij wannę.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

Opróżnij wannę.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

Napełnij wannę do połowy.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

Zwiększ poziom wypełnienia wanny o 1 (wymagany jest atrybut ordered, czyli true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

Urządzenie ERRORS

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