Skema Trait Smart Home Cook
action.devices.traits.Cook
- Ciri ini milik 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 mencakup 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.
ATTRIBUTE Perangkat
Perangkat dengan ciri ini dapat melaporkan atribut berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
Fulfillment intent.
Atribut | Type | Deskripsi |
---|---|---|
supportedCookingModes |
Array |
Wajib. Mode memasak yang didukung oleh perangkat ini. |
[item, ...] |
String |
Mode memasak. Nilai yang didukung:
|
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 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:
|
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 ada. |
[item, ...] |
String |
Nama sinonim preset. |
lang |
String |
Wajib. Kode bahasa (ISO 639-1). Lihat bahasa yang didukung. |
Contoh
Perangkat hanya dengan satu mode memasak dan 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
Entitas dengan karakteristik ini dapat melaporkan status berikut sebagai bagian dari operasi QUERY
. Untuk mempelajari
penanganan intent QUERY
lebih lanjut, lihat
Fulfillment intent.
Negara bagian | Type | Deskripsi |
---|---|---|
currentCookingMode |
String |
Wajib. Menjelaskan mode memasak saat ini yang disetel pada perangkat, dari daftar atribut |
currentFoodPreset |
String |
Menjelaskan masakan makanan saat ini di perangkat, dari daftar atribut |
currentFoodQuantity |
Number |
Menentukan jumlah masakan makanan saat ini yang terkait dengan |
currentFoodUnit |
String |
Unit yang terkait dengan |
Contoh
Apakah oven saya memasak?
{ "currentCookingMode": "BAKE" }
Apa yang dimasak di penanak nasi saya sekarang?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
Perangkat COMMAND
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 berhenti memasak.
Parameter
Parameter | Type | Deskripsi |
---|---|---|
start |
Boolean |
Wajib. True untuk mulai memasak, salah untuk menghentikan mode memasak saat ini. |
cookingMode |
String |
Meminta mode memasak untuk perangkat, dari atribut |
foodPreset |
String |
Nama preset makanan yang diminta oleh pengguna, dari atribut |
quantity |
Number |
Jumlah makanan yang diminta oleh pengguna. |
unit |
String |
Unit yang terkait dengan |
Contoh
Mulai memanggang di oven.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
Berhenti memanggang di oven.
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
Mulai memasak 2 cangkir nasi putih di penanak nasi saya.
{ "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 batas maksimum.unknownFoodPreset
- Pengguna meminta preset makanan yang tidak didukung oleh perangkat.