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