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: UNKNOWN_COOKING_MODE BAKE BEAT BLEND BOIL BREW BROIL CONVECTION_BAKE COOK DEFROST DEHYDRATE FERMENT FRY GRILL KNEAD MICROWAVE MIX PRESSURE_COOK PUREE ROAST SAUTE SLOW_COOK SOUS_VIDE STEAM STEW STIR WARM WHIP
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: UNKNOWN_UNITS NO_UNITS CENTIMETERS CUPS DECILITERS FEET FLUID_OUNCES GALLONS GRAMS INCHES KILOGRAMS LITERS METERS MILLIGRAMS MILLILITERS MILLIMETERS OUNCES PINCH PINTS PORTION POUNDS QUARTS TABLESPOONS TEASPOONS
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 supportedCookingModes. Można zgłosić tylko 1 tryb. Jeśli nie wybrano obecnie żadnego trybu, wartość powinna być ustawiona na BRAK.
currentFoodPreset	Ciąg	Opisuje gotowanie na urządzeniu z listy atrybutu foodPresets. Można zgłosić tylko jedno jedzenie. Jeśli obecnie nie wybrano żadnego jedzenia, należy ustawić wartość NONE.
currentFoodQuantity	Number	Definiuje bieżącą ilość potraw gotowanych w: currentFoodUnit, jeśli została podana ilość. Nie powinno być raportowane, jeśli w tej chwili nic nie jest gotowane lub nie ma ilości przypisanej do tego gotowego ustawienia.
currentFoodUnit	Ciąg	Jednostka powiązana z atrybutem currentFoodQuantity z listy atrybutów supported_units.

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 supportedCookingModes.
foodPreset	Ciąg	Nazwa gotowego ustawienia jedzenia, o które prosi użytkownik, podana w atrybucie foodPresets.
quantity	Number	Ilość jedzenia, która została zamówiona przez użytkownika.
unit	Ciąg	Jednostka powiązana z atrybutem quantity z atrybutu supported_units.

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.