Skema Sifat Memasak Smart Home

action.devices.traits.Cook - Sifat ini dimiliki oleh perangkat yang dapat memasak makanan sesuai dengan berbagai preset makanan dan mode memasak yang didukung.

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

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

ATRIBUT Perangkat

Perangkat dengan karakteristik ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC. Untuk mempelajari lebih lanjut cara menangani intent SYNC, lihat Fulfillment 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	Preset makanan.
food_preset_name	String	Wajib. Nama internal preset makanan, yang akan digunakan dalam perintah dan status. Nama ini mungkin tidak mudah digunakan, dan digunakan di 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 dalam setiap bahasa yang didukung.
[item, ...]	Objek	Nama makanan.
synonym	Array	Wajib. Sinonim untuk preset, harus menyertakan 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 dan tidak memiliki 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

Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY. Untuk mempelajari lebih lanjut cara menangani intent QUERY, lihat Fulfillment intent.

Negara bagian	Jenis	Deskripsi
currentCookingMode	String	Wajib. Menjelaskan mode memasak saat ini yang ditetapkan di perangkat, dari atribut supportedCookingModes. Hanya satu mode yang dapat dilaporkan. Jika saat ini tidak ada mode yang dipilih, setelan ini harus ditetapkan ke NONE.
currentFoodPreset	String	food_preset_name makanan yang sedang dimasak di perangkat, dari atribut foodPresets. Hanya satu makanan yang dapat dilaporkan. Jika saat ini tidak ada makanan yang dipilih, setelan ini harus ditetapkan ke NONE.
currentFoodQuantity	Number	Menentukan jumlah makanan yang sedang dimasak saat ini yang terkait dengan currentFoodUnit, jika jumlah ditentukan. Tidak boleh dilaporkan jika tidak ada yang sedang dimasak, atau jika tidak ada jumlah yang terkait dengan preset makanan ini.
currentFoodUnit	String	Unit yang terkait dengan currentFoodQuantity, dari daftar supported_units preset.

Contoh

Apakah oven saya sedang memasak?

{
  "currentCookingMode": "BAKE"
}

Apa yang sedang dimasak di penanak nasi saya sekarang?

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

Perintah Perangkat

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

action.devices.commands.Cook

Mulai atau hentikan memasak.

Parameter

Parameter	Jenis	Deskripsi
start	Boolean	Wajib. Benar untuk memulai memasak, salah untuk menghentikan mode memasak saat ini.
cookingMode	String	Meminta mode memasak untuk perangkat, 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 di oven saya.

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

Berhenti memanggang di oven saya.

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

Mulai memasak 2 cangkir nasi putih di penanak nasi.

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

Perangkat ERRORS

Lihat daftar lengkap error dan pengecualian.

• deviceDoorOpen - Pintu perangkat terbuka.
• deviceLidOpen - Penutup perangkat terbuka.
• fractionalAmountNotSupported - Pengguna meminta jumlah pecahan untuk preset makanan ini, tetapi tidak didukung oleh perangkat ini.
• amountAboveLimit - Pengguna meminta jumlah yang melebihi maksimum.
• unknownFoodPreset - Pengguna meminta preset makanan yang tidak didukung oleh perangkat.