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	String	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, ...]	String	Nazwa synonimu.
lang	String	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	String	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	String	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.