مخطط سمة الطهي المنزلي الذكي
action.devices.traits.Cook
- تنتمي هذه السمة إلى الأجهزة التي يمكنها طهي الطعام وفقًا للإعدادات المسبقة المختلفة وأوضاع الطهي المتوافقة.
تتضمن أمثلة أنواع هذه الأجهزة Multicooker وPressure cooker Blender، وMicrowave. قد تتضمن أوامر الطهي كمية واسم الطعام، مثل "كوبان من الأرز البني"، حيث "الأرز البني" هو إعداد مسبق للطعام للجهاز.
لا تتعامل هذه السمة مع وقت الطهي أو درجة حرارة الطهي. الاطّلاع على Timer وTemperatureControl لمزيد من المعلومات.
ATTRIBUTES للجهاز
يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي:
كجزء من عملية SYNC
. للتعلّم
مزيد من المعلومات عن التعامل مع SYNC
هدفًا. اطّلِع على
تحقيق النية بالشراء:
السمات | النوع | الوصف |
---|---|---|
supportedCookingModes |
مصفوفة |
يجب ملء هذا الحقل. أوضاع الطهي المتوافقة مع هذا الجهاز |
[item, ...] |
String |
وضع الطهي. القيم المسموح بها:
|
foodPresets |
مصفوفة |
الإعدادات المسبقة لأنواع معيّنة من الطعام. |
[item, ...] |
كائن |
إعداد مسبق للطعام. |
food_preset_name |
String |
يجب ملء هذا الحقل. الاسم الداخلي للإعداد المسبق الخاص بالطعام والذي سيتم استخدامه في الأوامر والولايات قد يكون هذا الاسم غير سهل الاستخدام، وتتم مشاركته بكل اللغات. |
supported_units |
مصفوفة |
يجب ملء هذا الحقل. تحتوي على جميع الوحدات المتوافقة مع الجهاز لوجبة معيّنة. |
[item, ...] |
String |
وحدة مسموح بها. القيم المسموح بها:
|
food_synonyms |
مصفوفة |
يجب ملء هذا الحقل. مرادفات أسماء الطعام للإعدادات المحددة مسبقًا بكل لغة متاحة. |
[item, ...] |
كائن |
اسم الطعام. |
synonym |
مصفوفة |
يجب ملء هذا الحقل. يجب أن تشتمل مرادفات الإعداد المسبق على صيغ المفرد والجمع، إن أمكن. |
[item, ...] |
String |
اسم مرادف معدّ مسبقًا. |
lang |
String |
يجب ملء هذا الحقل. رمز اللغة (وفقًا لمعيار ISO 639-1) الاطّلاع على اللغات المتاحة |
أمثلة
الجهاز لا يتضمّن سوى وضع طهي واحد وبدون إعداد مسبق.
{ "supportedCookingModes": [ "BAKE" ] }
جهاز يتضمن أوضاع طهي متعددة وإعدادات مسبقة للطعام
{ "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" } ] } ] }
حالة الجهاز
يجوز للكيانات التي تستخدم هذه السمة الإبلاغ عن ما يلي:
كجزء من عملية QUERY
. للتعلّم
مزيد من المعلومات عن التعامل مع QUERY
هدفًا. اطّلِع على
تحقيق النية بالشراء:
الولايات | النوع | الوصف |
---|---|---|
currentCookingMode |
String |
يجب ملء هذا الحقل. تصف هذه السمة وضع الطهي الحالي المضبوط على الجهاز، من سمة |
currentFoodPreset |
String |
|
currentFoodQuantity |
Number |
تحدّد هذه السمة الكمية الحالية لطهي الطعام المرتبطة بالسمة |
currentFoodUnit |
String |
الوحدة المرتبطة بالوحدة |
أمثلة
هل يتم طهي الفرن؟
{ "currentCookingMode": "BAKE" }
ما الذي يتم طهيه الآن في إناء طهي الأرز؟
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
CommandS للجهاز
قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي:
الأوامر كجزء من عملية EXECUTE
. للتعلّم
مزيد من المعلومات عن التعامل مع EXECUTE
هدفًا. اطّلِع على
تحقيق النية بالشراء:
action.devices.commands.Cook
بدء الطهي أو إيقافه
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
start |
منطقي |
يجب ملء هذا الحقل. صحيح لبدء الطهي، وخطأ لإيقاف وضع الطهي الحالي. |
cookingMode |
String |
تم طلب وضع الطهي للجهاز من سمة |
foodPreset |
String |
تمثّل هذه السمة اسم إعداد الطعام المسبَق الذي طلبه المستخدم، بدءًا من السمة |
quantity |
Number |
كمية الطعام التي طلبها المستخدم. |
unit |
String |
تمثّل هذه السمة الوحدة المرتبطة بالسمة |
أمثلة
أريد بدء خَبز الفرن في الفرن.
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "BAKE" } }
التوقّف عن خَبز الفرن
{ "command": "action.devices.commands.Cook", "params": { "start": false, "cookingMode": "BAKE" } }
البدء في طهي كوبَين من الأرز الأبيض في إناء طهي الأرز
{ "command": "action.devices.commands.Cook", "params": { "start": true, "cookingMode": "COOK", "foodPreset": "white_rice", "quantity": 2, "unit": "CUPS" } }
أخطاء الجهاز
اطّلع على القائمة الكاملة الأخطاء والاستثناءات.deviceDoorOpen
: باب الجهاز مفتوح.deviceLidOpen
- غطاء الجهاز مفتوح.fractionalAmountNotSupported
- طلب المستخدم مبلغًا جزئيًّا لهذا المبلغ إعداد مسبق للطعام، ولكنّه غير متوافق مع هذا الجهاز.amountAboveLimit
: طلب المستخدم كمية أكبر من الحدّ الأقصىunknownFoodPreset
- طلب المستخدم إعدادًا مسبقًا للطعام غير متوافق مع الجهاز.