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.