Witamy w Google Home Developer Center – nowym miejscu, z którego dowiesz się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.
Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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.