Schemat inteligentnego domu Cook
action.devices.traits.Cook
– ten atrybut należy do urządzeń, które gotują jedzenie według różnych gotowych ustawień i obsługiwanych trybów gotowania.
Przykłady tego typu urządzeń to urządzenie do gotowania, mikser ciśnieniowy, mikser i mikrofalówka. Polecenia dotyczące gotowania mogą zawierać ilość i nazwę posiłku, takie jak „Dwoma filiżanka brązowego ryżu”, gdzie „brązowy ryż” to gotowe ustawienie na urządzeniu.
Nie ma wpływu na czas gotowania ani temperaturę gotowania. Więcej informacji znajdziesz w sekcji Timer i TemperatureControl.
ATRYBUTY 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 |
Wymagany. Tryby gotowania obsługiwane przez to urządzenie. |
[item, ...] |
Ciąg |
Tryb gotowania. Obsługiwane wartości:
|
foodPresets |
Tablica |
Gotowe ustawienia dla określonych typów jedzenia. |
[item, ...] |
Obiekt |
Gotowe ustawienia jedzenia. |
food_preset_name |
Ciąg |
Wymagany. Wewnętrzna nazwa gotowych ustawień, która będzie używana w poleceniach i stanach. Ta nazwa może nie być przyjazna dla użytkownika i jest dostępna we wszystkich językach. |
supported_units |
Tablica |
Wymagany. Zawiera wszystkie jednostki obsługiwane przez urządzenie w przypadku konkretnego jedzenia. |
[item, ...] |
Ciąg |
Obsługiwana jednostka. Obsługiwane wartości:
|
food_synonyms |
Tablica |
Wymagany. Synonimy nazwy jedzenia z każdego gotowego języka. |
[item, ...] |
Obiekt |
Nazwa jedzenia. |
synonym |
Tablica |
Wymagany. Synonimy gotowych ustawień powinny być użyte w liczbie pojedynczej i mnogiej (w stosownych przypadkach). |
[item, ...] |
Ciąg |
Nazwa gotowego synonimu. |
lang |
Ciąg |
Wymagany. Kod języka (ISO 639-1). Zobacz obsługiwane języki. |
Przykłady
Urządzenie z 1 trybem gotowania i bez gotowych ustawień.
{ "supportedCookingModes": [ "BAKE" ] }
Urządzenie z różnymi 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 o tym atrybucie mogą raportować te stany. Więcej informacji o obsłudze intencji QUERY
znajdziesz w sekcji Realizacja intencji.
Stany | Typ | Opis |
---|---|---|
currentCookingMode |
Ciąg |
Wymagany. Opisuje bieżący tryb gotowania ustawiony na urządzeniu z listy atrybutów |
currentFoodPreset |
Ciąg |
Opisuje gotowanie na urządzeniu z listy atrybutu |
currentFoodQuantity |
Number |
Definiuje bieżącą ilość potraw gotowanych w: |
currentFoodUnit |
Ciąg |
Jednostka powiązana z atrybutem |
Przykłady
Czy piekarnik gotuje?
{ "currentCookingMode": "BAKE" }
Co jest teraz gotowane w mojej wypieku ryżu?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
Polecenie urządzenia
W ramach operacji EXECUTE
urządzenia z tą cechą mogą odpowiadać na podane niżej polecenia. Więcej informacji o obsłudze intencji EXECUTE
znajdziesz w sekcji Realizacja intencji.
action.devices.commands.Cook
Możesz rozpocząć lub zakończyć gotowanie.
Parametry
Parametry | Typ | Opis |
---|---|---|
start |
Wartość logiczna |
Wymagany. Prawda, aby rozpocząć gotowanie, lub fałsz, aby zatrzymać obecny tryb gotowania. |
cookingMode |
Ciąg |
Żądany tryb gotowania urządzenia z poziomu atrybutu |
foodPreset |
Ciąg |
Nazwa gotowego ustawienia jedzenia, o które prosi użytkownik, podana w atrybucie |
quantity |
Number |
Ilość jedzenia, która została zamówiona przez użytkownika. |
unit |
Ciąg |
Jednostka powiązana z atrybutem |
Przykłady
Zacznij piec w piekarniku
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Nie piecz w piekarniku.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Zacznij gotować 2 szklanki białego ryżu w garnku ryżowym.
{ "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 jest obsługiwane.amountAboveLimit
– użytkownik poprosił o ilość większą niż maksymalna.unknownFoodPreset
– użytkownik zażądał gotowych ustawień jedzenia, które nie są obsługiwane przez urządzenie.