Schemat funkcji inteligentnego domu
action.devices.traits.Cook
– ta cecha należy do urządzeń, które mogą gotować jedzenie według różnych gotowych ustawień i obsługiwanych trybów gotowania.
Przykładami tych typów urządzeń są mikser kuchenny, urządzenie do gotowania ciśnieniowego, mikser i mikrofalówka. Polecenia kucharza mogą zawierać liczbę i nazwę dania, np. „2 filiżanki brązowego ryżu” – „brązowy ryż” to gotowe ustawienie na urządzeniu.
Ta cecha nie uwzględnia czasu gotowania ani temperatury. Więcej informacji znajdziesz w sekcjach Licznik czasu i TemperatureControl.
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 |
---|---|---|
supportedCookingModes |
Tablica |
Wymagane. Tryby gotowania obsługiwane przez to urządzenie. |
[item, ...] |
Ciąg |
Tryb gotowania. Obsługiwane wartości:
|
foodPresets |
Tablica |
Gotowe ustawienia dla określonych rodzajów jedzenia. |
[item, ...] |
Obiekt |
Gotowe ustawienia jedzenia. |
food_preset_name |
Ciąg |
Wymagane. Wewnętrzna nazwa gotowych ustawień jedzenia, która będzie używana w poleceniach i stanach. Ta nazwa może nie być łatwa w użyciu i dostępna we wszystkich językach. |
supported_units |
Tablica |
Wymagane. Zawiera wszystkie jednostki obsługiwane przez urządzenie w przypadku określonego jedzenia. |
[item, ...] |
Ciąg |
Obsługiwana jednostka. Obsługiwane wartości:
|
food_synonyms |
Tablica |
Wymagane. Synonimy nazwy gotowego ustawienia w każdym obsługiwanym języku. |
[item, ...] |
Obiekt |
Nazwa jedzenia. |
synonym |
Tablica |
Wymagane. Synonimy gotowego ustawienia powinny zawierać liczbę mnogą i mnogę (w stosownych przypadkach). |
[item, ...] |
Ciąg |
Gotowe ustawienia synonimów. |
lang |
Ciąg |
Wymagane. Kod języka (ISO 639-1). Zobacz obsługiwane języki. |
Przykłady
Urządzenie z jednym trybem gotowania i bez gotowych ustawień.
{ "supportedCookingModes": [ "BAKE" ] }
Urządzenie z wieloma trybami gotowania i gotowymi potrawami.
{ "supportedCookingModes": [ "COOK", "WARM" ], "foodPresets": [ { "food_preset_name": "white_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "White Rice", "Rice" ], "lang": "en" } ] }, { "food_preset_name": "brown_rice", "supported_units": [ "CUPS" ], "food_synonyms": [ { "synonym": [ "Brown Rice" ], "lang": "en" } ] } ] }
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 |
---|---|---|
currentCookingMode |
Ciąg |
Wymagane. Opisuje obecny tryb gotowania ustawiony na urządzeniu z listy atrybutu |
currentFoodPreset |
Ciąg |
Opisuje bieżące gotowanie z urządzenia za pomocą listy atrybutu |
currentFoodQuantity |
Number |
Określa bieżącą ilość jedzenia przystosowaną do funkcji |
currentFoodUnit |
Ciąg |
Jednostka powiązana z elementem |
Przykłady
Czy gotuję piekarnik?
{ "currentCookingMode": "BAKE" }
Co teraz gotuję w urządzeniu z ryżem?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
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.Cook
Włącz lub wyłącz gotowanie.
Parametry
Parametry | Typ | Opis |
---|---|---|
start |
Wartość logiczna |
Wymagane. Prawda, aby rozpocząć gotowanie, albo fałsz, aby zatrzymać obecny tryb gotowania. |
cookingMode |
Ciąg |
Żądany tryb gotowania na urządzeniu podany z atrybutu |
foodPreset |
Ciąg |
Nazwa zdefiniowanego przez użytkownika gotowego ustawienia produktu, określone na podstawie atrybutu |
quantity |
Number |
Ilość jedzenia zamówiona przez użytkownika. |
unit |
Ciąg |
Jednostka powiązana z atrybutem |
Przykłady
Zacznij piec w piecu.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Wyłącz pieczenie w piekarniku.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Zacznij gotować 2 szklanki białego ryżu w moim urządzeniu do gotowania ryżu.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
Urządzenie ERRORS
Zobacz pełną listę błędów i wyjątków.deviceDoorOpen
– drzwi urządzenia są otwarte.deviceLidOpen
– pokrywa urządzenia jest otwarta.fractionalAmountNotSupported
– użytkownik zażądał ułamkowej wartości w przypadku tego gotowego ustawienia jedzenia, ale to urządzenie nie obsługuje tej funkcji.amountAboveLimit
– użytkownik wysłał żądanie, które przekroczyło limit.unknownFoodPreset
– użytkownik poprosił o gotowe ustawienia jedzenia, które nie są obsługiwane przez urządzenie.