Schemat funkcji Smart Home Fill

action.devices.traits.Fill – ta cecha dotyczy urządzeń, które można napełniać, np. wanny.

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
availableFillLevels	Obiekt	Opisuje różne poziomy napełnienia urządzenia.
levels	Tablica	Wymagane. Lista nazw poziomów i synonimów typowych dla danego języka.
[item, ...]	Obiekt	Nazwa poziomu i synonimy dla danego języka.
level_name	String	Wymagane. Wewnętrzna nazwa poziomu. Tekst ten może nie być przyjazny dla użytkownika i będzie udostępniany 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 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.
ordered	Wartość logiczna	Wymagane. Jeśli ma wartość true (prawda), urządzenie obsługuje dodatkową gramatykę do zwiększania lub zmniejszania logiki, co jest reprezentowane przez tablicę levels (na przykład do połowy poziomu).
supportsFillPercent	Wartość logiczna	(Domyślnie: false) Jeśli wartość to prawda, zaakceptuj polecenia umożliwiające dostosowanie poziomu do wartości procentowej.

Przykłady

Urządzenie z podstawowymi funkcjami napełniania i opróżniania, które nie obsługuje dyskretnych poziomów wypełnienia.

{}

Urządzenie, które obsługuje dyskretne poziomy 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

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
isFilled	Wartość logiczna	Wymagane. Prawda, jeśli dane na urządzeniu są wypełnione na dowolnym poziomie. Wartość fałsz, jeśli urządzenie jest całkowicie opróżniane.
currentFillLevel	String	Wymagany, jeśli atrybut availableFillLevels jest ustawiony. Wskazuje bieżącą wartość level_name z atrybutu availableFillLevels, w której dane urządzenie jest wypełnione.
currentFillPercent	Number	Wymagany, jeśli atrybut supportsFillPercent jest ustawiony. Wskazuje bieżący poziom wypełnienia.

Przykłady

Czy wanna jest napełniona?

{
  "isFilled": true
}

Czy wanna jest napełniona? (z poziomami).

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

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

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

Parametry

Parametry	Typ	Opis
fill	Wartość logiczna	Wymagane. Prawda, aby wypełnić, fałsz, aby opróżnić.
fillLevel	String	Wskazuje wartość level_name z atrybutu availableFillLevels do ustawienia. Jeśli nie określono inaczej, wypełnij poziom domyślny.
fillPercent	Number	Wskazuje wartość procentową poziomu żądanego.

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 jeden (wymagany atrybut ordered musi mieć wartość 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.