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

action.devices.traits.Cook – ta cecha należy do urządzeń, które mogą gotować według różnych gotowych ustawień i obsługiwanych trybów gotowania.

Przykładami takich typów urządzeń są cooker, mikser ciśnieniowy, mikser i mikrofalówka. Polecenia dotyczące gotowania mogą zawierać ilość i nazwę pokarmu, np. „2 szklanki brązowego ryżu”, gdzie „brązowy ryż” to gotowe ustawienie na urządzeniu.

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

ATRYBUTY na urządzeniu

Urządzenia z tą cechą mogą zgłaszać w ramach operacji SYNC te atrybuty. Więcej informacji o obsłudze intencji SYNC znajdziesz w artykule 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 potraw, która będzie używana w poleceniach i stanach. Ta nazwa może być nieprzydatna i jest dostępna we wszystkich językach.

supported_units Tablica

Wymagane.

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

Wymagane.

Synonimy nazwy jedzenia dla gotowych ustawień w każdym obsługiwanym języku.

[item, ...] Obiekt

Nazwa jedzenia.

synonym Tablica

Wymagane.

Synonimy gotowych ustawień powinny być zarówno w liczbie pojedynczej, jak i mnogiej (w stosownych przypadkach).

[item, ...] Ciąg

Nazwa gotowego synonimu.

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

STANY urządzenia

Urządzenia z tą cechą mogą w ramach operacji QUERY zgłaszać następujące stany. Więcej informacji o obsłudze intencji QUERY znajdziesz w artykule Realizacja intencji.

Stany Typ Opis
currentCookingMode Ciąg

Wymagane.

Opisuje aktualny tryb gotowania ustawiony na urządzeniu z listy atrybutu supportedCookingModes. Raport może zawierać tylko jeden tryb. Jeśli nie wybrano żadnego trybu, ustaw go na NIE.

currentFoodPreset Ciąg

Opisuje obecnie gotowane jedzenie na urządzeniu z listy atrybutu foodPresets. Można zgłosić tylko jedno jedzenie. Jeśli nie wybrano obecnie żadnego jedzenia, ustaw wartość BRAK.

currentFoodQuantity Number

Określa obecną ilość jedzenia podawanego w currentFoodUnit, jeśli określono jego ilość. Nie powinny być zgłaszane, jeśli nic się obecnie nie przygotowuje lub nie ma żadnej ilości przypisanej do tego gotowego ustawienia.

currentFoodUnit Ciąg

Jednostka powiązana z atrybutem currentFoodQuantity z listy atrybutu supported_units.

Przykłady

Czy mój piekarnik gotuje?

{
  "currentCookingMode": "BAKE"
}

Co teraz robi się w mojej gotowni ryżu?

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

Polecenia dotyczące urządzenia

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

action.devices.commands.Cook

Włącz lub wyłącz gotowanie.

Parametry

Parametry Typ Opis
start Wartość logiczna

Wymagane.

Prawda, aby rozpocząć gotowanie, lub fałsz, aby zatrzymać obecny tryb gotowania.

cookingMode Ciąg

Zażądano trybu gotowania urządzenia z poziomu atrybutu supportedCookingModes.

foodPreset Ciąg

Nazwa gotowego atrybutu wybranego przez użytkownika w atrybucie foodPresets.

quantity Number

Ilość jedzenia wymaganej 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"
  }
}

Wyłącz pieczenie w piekarniku.

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

Zacznij gotować 2 szklanki białego ryżu w mojej potrawy.

{
  "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 poprosił o ustaloną wartość ułamkową dla tych gotowych ustawień, ale to urządzenie nie obsługuje tej wartości.
  • amountAboveLimit – użytkownik poprosił o ilość powyżej określonego limitu.
  • unknownFoodPreset – użytkownik poprosił o ustawienie gotowe do jedzenia, które nie jest obsługiwane przez urządzenie.