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: 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 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: 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 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 supportedCookingModes. Można zgłosić tylko 1 tryb. Jeśli obecnie nie wybrano żadnego trybu, należy ustawić go na BRAK.
currentFoodPreset	Ciąg	Opisuje bieżące gotowanie z urządzenia za pomocą listy atrybutu foodPresets. Można zgłosić tylko jedno jedzenie. Jeśli obecnie nie wybrano żadnego jedzenia, powinno ono być ustawione na BRAK.
currentFoodQuantity	Number	Określa bieżącą ilość jedzenia przystosowaną do funkcji currentFoodUnit, jeśli została podana ilość. Nie należy podawać w przypadku braku gotowania lub braku ilości przypisanego gotowego ustawienia.
currentFoodUnit	Ciąg	Jednostka powiązana z elementem currentFoodQuantity z listy atrybutu supported_units.

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 supportedCookingModes.
foodPreset	Ciąg	Nazwa zdefiniowanego przez użytkownika gotowego ustawienia produktu, określone na podstawie atrybutu foodPresets.
quantity	Number	Ilość jedzenia zamówiona przez użytkownika.
unit	Ciąg	Jednostka powiązana z atrybutem quantity z atrybutu supported_units.

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.