Witamy w Google Home Developer Center – nowym miejscu, gdzie możesz dowiedzieć się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

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.