Schemat cechy inteligentnego gotowania

action.devices.traits.Cook – ta cecha dotyczy urządzeń, które mogą gotować żywność zgodnie z różnymi wstępnymi ustawieniami i obsługiwanymi trybami gotowania.

Przykłady tych typów urządzeń to Multicooker, Pressure cooker, Blender i Microwave. Polecenia dotyczące gotowania mogą zawierać ilość i nazwę potrawy, np. „2 szklanki brązowego ryżu”, gdzie „brązowy ryż” to potrawa wstępnie ustawiona na urządzeniu.

Ta funkcja nie uwzględnia czasu gotowania ani temperatury gotowania. Więcej informacji znajdziesz w artykułach Timer i TemperatureControl.

ATRYBUTY URZĄDZENIA

Urządzenia z tą cechą mogą zgłaszać wymienione niżej atrybuty w ramach operacji SYNC. Więcej informacji o obsługiwaniu intencji SYNC znajdziesz w artykule Realizacja intencji.

Atrybuty	Typ	Opis
supportedCookingModes	Tablica	Wymagany. Tryby gotowania obsługiwane przez to urządzenie.
[item, ...]	String	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	Wstępnie ustawione wartości dla określonych rodzajów żywności.
[item, ...]	Obiekt	Gotowy zestaw dotyczący jedzenia.
food_preset_name	String	Wymagane. Wewnętrzna nazwa gotowych ustawień jedzenia, która będzie używana w komendach i stanach. Nazwa może być nieprzyjazna dla użytkowników i być taka sama we wszystkich językach.
supported_units	Tablica	Wymagany. Zawiera wszystkie jednostki obsługiwane przez urządzenie w przypadku określonej żywności.
[item, ...]	String	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	Wymagane. synonimy nazwy produktu w ramach gotowego ustawienia w każdym obsługiwanym języku;
[item, ...]	Obiekt	Nazwa jedzenia.
synonym	Tablica	Wymagany. Synonimy wstępnie ustawionego obrazu powinny zawierać formy liczby pojedynczej i mnogiej (w odpowiednich przypadkach).
[item, ...]	String	Nazwa gotowego synonimu.
lang	String	Wymagany. Kod języka (ISO 639-1). Zobacz obsługiwane języki.

Przykłady

Urządzenie z jednym trybem gotowania i bez wstępnie ustawionych wartości.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Urządzenie z wieloma trybami gotowania i gotowymi ustawieniami potraw.

{
  "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"
        }
      ]
    }
  ]
}

STANOWISKO URZĄDZENIA

Elementy z tą cechą mogą raportować te stany w ramach operacji QUERY. Więcej informacji o obsługiwaniu intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany	Typ	Opis
currentCookingMode	String	Wymagane. Opis bieżącego trybu gotowania ustawionego na urządzeniu na podstawie atrybutu supportedCookingModes. Można zgłosić tylko jeden tryb. Jeśli żaden tryb nie jest obecnie wybrany, należy ustawić wartość NONE (Brak).
currentFoodPreset	String	food_preset_name aktualnego jedzenia gotowanego na urządzeniu, z atrybutu foodPresets. Można zgłosić tylko jedno jedzenie. Jeśli nie ma obecnie wybranego żadnego jedzenia, należy ustawić opcję NONE (brak).
currentFoodQuantity	Number	Określa bieżącą ilość jedzenia gotowanego powiązanego z currentFoodUnit, jeśli podano ilość. Nie można go zgłosić, jeśli aktualnie nic się nie gotuje lub nie jest powiązana z tym ustawieniem Ilość.
currentFoodUnit	String	Jednostka powiązana z urządzeniem currentFoodQuantity z listy supported_units gotowych ustawień.

Przykłady

Czy piekarnik pracuje?

{
  "currentCookingMode": "BAKE"
}

Co się teraz gotuje w moim parowarze?

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

Polecenia urządzenia

Urządzenia z tą cechą mogą odpowiadać na te polecenia w ramach operacji EXECUTE. Więcej informacji o obsługiwaniu intencji EXECUTE znajdziesz w artykule Realizacja intencji.

action.devices.commands.Cook

Rozpocznij lub zatrzymaj gotowanie.

Parametry

Parametry	Typ	Opis
start	Wartość logiczna	Wymagany. Prawda, aby rozpocząć gotowanie, fałsz, by zatrzymać bieżący tryb gotowania.
cookingMode	String	Żądany tryb gotowania urządzenia z atrybutu supportedCookingModes.
foodPreset	String	Nazwa gotowego ustawienia jedzenia żądanego przez użytkownika (pochodzi z atrybutu foodPresets).
quantity	Number	Ilość jedzenia zamówiona przez użytkownika.
unit	String	Jednostka powiązana z elementem quantity z atrybutu supported_units.

Przykłady

Rozpocznij pieczenie w mojej kuchni.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "BAKE"
  }
}

Przestań piec w piekarniku.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": false,
    "cookingMode": "BAKE"
  }
}

Zacznij gotować 2 szklanki białego ryżu w garnku do gotowania ryżu.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

BŁĘDY urządzenia

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 poprosił o ułamkową kwotę tego gotowego ustawienia jedzenia, ale to urządzenie nie obsługuje tej formy płatności.
• amountAboveLimit – użytkownik poprosił o liczbę, która przekroczyła maksimum.
• unknownFoodPreset – użytkownik zażądał gotowych ustawień, które nie są obsługiwane przez urządzenie.