مخطط سمات الطهي الذكي في المنزل
action.devices.traits.Cook
: تنتمي هذه السمة إلى أجهزة يمكنها طهي الطعام وفقًا لعدّة إعدادات مسبقة للأطعمة وأوضاع الطهي المتوافقة.
وتشمل الأمثلة على هذه الأنواع من الأجهزة جهاز الطهو المتعدّد وجهاز طهي بالضغط والخلاط والموجات الصغرية. قد تتضمن أوامر الطهي كمية الطعام واسمه، مثل "كوبَين من الأرز البني"، حيث يكون "الأرز البني" إعدادًا مسبقًا للطعام مخصصًا للجهاز.
لا تتعامل هذه السمة مع وقت الطهي أو درجة حرارة الطهي. للحصول على مزيد من المعلومات، يمكنك الاطّلاع على الموقّت وTemperatureControl.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
supportedCookingModes |
المصفوفة |
مطلوبة. أوضاع الطهي المتوافقة مع هذا الجهاز. |
[item, ...] |
سلسلة |
وضع الطهي. القيم المسموح بها:
|
foodPresets |
المصفوفة |
الإعدادات المسبقة لأنواع معينة من الطعام. |
[item, ...] |
العنصر |
إعداد مسبق للطعام. |
food_preset_name |
سلسلة |
مطلوبة. الاسم الداخلي للإعداد المسبق للطعام، والذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا الاسم غير سهل الاستخدام، وتتم مشاركته عبر جميع اللغات. |
supported_units |
المصفوفة |
مطلوبة. يحتوي على جميع الوحدات التي يدعمها الجهاز في نوع معين من الطعام. |
[item, ...] |
سلسلة |
الوحدة المتوافقة. القيم المسموح بها:
|
food_synonyms |
المصفوفة |
مطلوبة. مترادفات أسماء الأغذية في الإعداد المسبق بكل لغة معتمدة. |
[item, ...] |
العنصر |
اسم الطعام. |
synonym |
المصفوفة |
مطلوبة. يجب أن تتضمن مرادفات الإعداد المسبق كلاً من صيغ المفرد والجمع، إن أمكن. |
[item, ...] |
سلسلة |
اسم المرادفات مسبقة الإعداد. |
lang |
سلسلة |
مطلوبة. رمز اللغة (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" } ] } ] }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
currentCookingMode |
سلسلة |
مطلوبة. يصف هذا الإعداد وضع الطهي الحالي الذي تم ضبطه على الجهاز من قائمة السمة |
currentFoodPreset |
سلسلة |
يصف هذا الحقل الطهي الحالي للطعام في الجهاز من قائمة السمات |
currentFoodQuantity |
Number |
تحدّد مقدار الطهي الحالي للطعام المرتبط بـ |
currentFoodUnit |
سلسلة |
الوحدة المرتبطة بالسمة |
أمثلة
هل يطهو الفرن؟
{ "currentCookingMode": "BAKE" }
ماذا يطهو في فرن الأرز الآن؟
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.Cook
بدء الطهي أو إيقافه.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
start |
منطقي |
مطلوبة. True لبدء الطهي أو على "false" لإيقاف وضع الطهي الحالي. |
cookingMode |
سلسلة |
تم طلب وضع الطهي للجهاز من السمة |
foodPreset |
سلسلة |
اسم الإعداد المسبق للطعام الذي طلبه المستخدم، من السمة |
quantity |
Number |
كمية الطعام التي يطلبها المستخدم. |
unit |
سلسلة |
الوحدة المرتبطة بالسمة |
أمثلة
ابدأ الخَبْز في الفرن.
{ "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
- طلب المستخدم إعداد طعام مسبقًا لا يتيحه الجهاز.