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ę |
supportsFillPercent |
Wartość logiczna |
(Domyślnie: 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 |
currentFillPercent |
Number |
Wymagany, jeśli atrybut |
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ść |
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" } }