Selamat datang di Pusat Developer Google Home, tujuan baru untuk mempelajari cara mengembangkan tindakan smart home. Catatan: Anda akan terus membuat tindakan di konsol Actions.
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Skema Baki Smart Home

action.devices.traits.Cook - Sifat ini termasuk dalam perangkat yang dapat memasak makanan berdasarkan berbagai preset makanan dan mode memasak yang didukung.

Contoh jenis perangkat ini meliputi Multicooker, Pressure cooker, Blender, dan Microwave. Perintah memasak dapat mencakup jumlah dan nama makanan, seperti "Dua cangkir beras merah", dengan "beras cokelat" adalah preset makanan untuk perangkat.

Sifat ini tidak menangani waktu memasak atau suhu memasak. Lihat Timer dan TemperatureControl untuk informasi selengkapnya.

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari penanganan intent SYNC lebih lanjut, lihat Penjelasan intent.

Atribut Jenis Deskripsi
supportedCookingModes Array

Wajib.

Mode memasak yang didukung oleh perangkat ini.

[item, ...] String

Mode memasak.

Nilai yang didukung:

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 Array

Preset untuk jenis makanan tertentu.

[item, ...] Objek

Prasetel makanan.

food_preset_name String

Wajib.

Nama internal preset makanan, yang akan digunakan dalam perintah dan status. Nama ini tidak mudah digunakan oleh pengguna, dan dibagikan ke semua bahasa.

supported_units Array

Wajib.

Berisi semua unit yang didukung oleh perangkat untuk makanan tertentu.

[item, ...] String

Unit yang didukung.

Nilai yang didukung:

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 Array

Wajib.

Sinonim nama makanan untuk preset di setiap bahasa yang didukung.

[item, ...] Objek

Nama makanan.

synonym Array

Wajib.

Sinonim untuk preset, harus mencakup bentuk tunggal dan jamak, jika berlaku.

[item, ...] String

Nama sinonim preset.

lang String

Wajib.

Kode bahasa (ISO 639-1). Lihat bahasa yang didukung.

Contoh

Perangkat yang hanya memiliki satu mode memasak tanpa preset.

{
  "supportedCookingModes": [
    "BAKE"
  ]
}

Perangkat dengan beberapa mode memasak dan preset makanan.

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

STATUS Perangkat

Perangkat dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari penanganan intent QUERY lebih lanjut, lihat Penjelasan intent.

Negara bagian Jenis Deskripsi
currentCookingMode String

Wajib.

Menjelaskan mode memasak yang saat ini disetel di perangkat, dari daftar atribut supportedCookingModes. Hanya satu mode yang dapat dilaporkan. Jika tidak ada mode yang dipilih saat ini, mode ini harus disetel ke NONE.

currentFoodPreset String

Menjelaskan memasak makanan saat ini di perangkat, dari daftar atribut foodPresets. Hanya satu makanan yang dapat dilaporkan. Jika tidak ada makanan yang dipilih saat ini, ini harus disetel ke NONE.

currentFoodQuantity Number

Menentukan jumlah saat ini memasak makanan yang dikaitkan dengan currentFoodUnit, jika kuantitas ditentukan. Tidak boleh dilaporkan jika tidak ada yang sedang dimasak, atau jika tidak ada kuantitas yang terkait dengan preset makanan ini.

currentFoodUnit String

Unit yang terkait dengan currentFoodQuantity, dari daftar atribut supported_units.

Contoh

Apakah oven saya sedang dimasak?

{
  "currentCookingMode": "BAKE"
}

Masakan apa yang sedang dilakukan di penanak nasi saya?

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

PERMINTAAN Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari penanganan intent EXECUTE lebih lanjut, lihat Penjelasan intent.

action.devices.commands.Cook

Mulai atau hentikan memasak.

Parameter

Parameter Jenis Deskripsi
start Boolean

Wajib.

True untuk mulai memasak, false untuk menghentikan mode memasak saat ini.

cookingMode String

Mode memasak untuk perangkat diminta, dari atribut supportedCookingModes.

foodPreset String

Nama preset makanan yang diminta oleh pengguna, dari atribut foodPresets.

quantity Number

Jumlah makanan yang diminta oleh pengguna.

unit String

Unit yang terkait dengan quantity, dari atribut supported_units.

Contoh

Mulai memanggang dalam oven saya.

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

Berhenti memanggang dalam oven saya.

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

Mulai memasak 2 cangkir nasi putih dalam penanak nasi saya.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

KESALAHAN perangkat

Lihat daftar lengkap error dan pengecualian.
  • deviceDoorOpen - Pintu perangkat terbuka.
  • deviceLidOpen - Tutup perangkat terbuka.
  • fractionalAmountNotSupported - Pengguna meminta jumlah pecahan untuk preset makanan ini, tetapi tidak didukung oleh perangkat ini.
  • amountAboveLimit - Pengguna meminta jumlah yang melebihi jumlah maksimum.
  • unknownFoodPreset - Pengguna meminta preset makanan yang tidak didukung oleh perangkat.