Schemat cechy Smart Home Cook

action.devices.traits.Cook – ta cecha dotyczy urządzeń, które mogą przygotowywać jedzenie zgodnie z różnymi gotowymi 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ę produktu spożywczego, np. „Dwie szklanki brązowego ryżu”, gdzie „brązowy ryż” to gotowe ustawienie urządzenia.

Ten atrybut nie obsługuje czasu ani temperatury gotowania. Więcej informacji znajdziesz w sekcjach Timer i TemperatureControl.

Atrybuty urządzenia

Urządzenia z tą cechą mogą zgłaszać te atrybuty w ramach operacji SYNC. Więcej informacji o obsłudze SYNC intencji 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	ustawienia wstępne dla określonych rodzajów żywności;
`[item, ...]`	Obiekt	Gotowy zestaw ustawień dotyczący jedzenia.
`food_preset_name`	String	Wymagany. Wewnętrzna nazwa gotowych ustawień dotyczących jedzenia, która będzie używana w poleceniach i stanach. Ta nazwa może być trudna do zrozumienia dla użytkowników i jest taka sama we wszystkich językach.
`supported_units`	Tablica	Wymagany. Zawiera wszystkie jednostki obsługiwane przez urządzenie w przypadku konkretnego produktu spożywczego.
`[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	Wymagany. Synonimy nazwy produktu spożywczego dla gotowego ustawienia w każdym obsługiwanym języku.
`[item, ...]`	Obiekt	Nazwa produktu spożywczego. Aby zapewnić działanie awaryjne w przypadku języka, wymagany jest co najmniej 1 produkt z wartością `lang` równą `en`.
`synonym`	Tablica	Wymagany. Synonimy ustawienia wstępnego powinny obejmować zarówno formy liczby pojedynczej, jak i mnogiej, jeśli ma to zastosowanie.
`[item, ...]`	String	Nazwa synonimu gotowego ustawienia. Aby zapewnić działanie awaryjne w przypadku języka, wymagany jest co najmniej 1 produkt z wartością `lang` równą `en`.
`lang`	String	Wymagany. Kod języka (ISO 639-1). Sprawdź obsługiwane języki.

Przykłady

Urządzenie z tylko jednym trybem gotowania i bez gotowych ustawień.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Urządzenie z wieloma trybami gotowania i gotowymi ustawieniami.

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

Stany urządzenia

Elementy z tym atrybutem mogą zgłaszać te stany w ramach operacji QUERY. Więcej informacji o obsłudze QUERY intencji znajdziesz w artykule Realizacja intencji.

Stany	Typ	Opis
`currentCookingMode`	String	Wymagany. Opisuje bieżący tryb gotowania ustawiony 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.
`currentFoodPreset`	String	`food_preset_name` aktualnie przygotowywanego jedzenia na urządzeniu, z atrybutu `foodPresets`. Można zgłosić tylko 1 produkt spożywczy. Jeśli nie wybrano obecnie żadnego produktu spożywczego, należy ustawić wartość NONE.
`currentFoodQuantity`	Number	Określa aktualną ilość przygotowywanego jedzenia powiązanego z właściwością `currentFoodUnit`, jeśli podano ilość. Nie należy zgłaszać, jeśli nic się nie gotuje lub jeśli z tym ustawieniem wstępnym dotyczącym jedzenia nie jest powiązana żadna ilość.
`currentFoodUnit`	String	Jednostka powiązana z `currentFoodQuantity` na liście `supported_units` w ustawieniu wstępnym.

Przykłady

Czy piekarnik piecze?

{
  "currentCookingMode": "BAKE"
}

Co się teraz gotuje w moim urządzeniu do gotowania ryżu?

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

Polecenia dotyczące urządzenia

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

`action.devices.commands.Cook`

rozpocząć lub zatrzymać gotowanie;

Parametry

Parametry	Typ	Opis
`start`	Wartość logiczna	Wymagany. Wartość „true” oznacza rozpoczęcie gotowania, a „false” – zatrzymanie bieżącego trybu gotowania.
`cookingMode`	String	Żądany tryb gotowania urządzenia z atrybutu `supportedCookingModes`.
`foodPreset`	String	Nazwa gotowego ustawienia dotyczącego jedzenia, o które prosi użytkownik, pochodząca z atrybutu `foodPresets`.
`quantity`	Number	Ilość jedzenia, o którą prosi użytkownik.
`unit`	String	Jednostka powiązana z wartością `quantity` z atrybutu `supported_units`.

Przykłady

Rozpocznij pieczenie w piekarniku.

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

Przestań piec w moim 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"
  }
}

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łamek ilości dla tego gotowego ustawienia jedzenia, ale nie jest to obsługiwane przez to urządzenie.
amountAboveLimit – użytkownik poprosił o ilość przekraczającą maksimum.
unknownFoodPreset – użytkownik zażądał gotowych ustawień, które nie są obsługiwane przez urządzenie.