مخطط سمات الطهي في المنزل المزوّد بأجهزة ذكية

action.devices.traits.Cook: تنتمي هذه السمة إلى الأجهزة التي يمكنها طهي الطعام وفقًا لإعدادات مسبقة مختلفة للطعام وأوضاع الطهي المتوافقة.

وتشمل الأمثلة على أنواع هذه الأجهزة Multicooker وPressure cooker وBlender وMicrowave. وقد تتضمن طلبات الطهي كمية الطعام واسمه، مثل "كؤوس من الأرز البني"، حيث "الأرز البني" هو إعداد مسبق للطعام للجهاز.

لا تتعامل هذه السمة مع وقت الطهي أو درجة حرارة الطهي. يمكنك الاطّلاع على Timer وTemperatureControl للحصول على مزيد من المعلومات.

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. لمزيد من المعلومات عن التعامل مع أغراض SYNC، يُرجى الاطّلاع على تنفيذ النية.

السمات	Type	الوصف
supportedCookingModes	صفيف	يجب ملء هذا الحقل. أوضاع الطهي المتوافقة مع هذا الجهاز
[item, ...]	String	وضع الطهي القيم المسموح بها: 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	صفيف	الإعدادات المسبقة لأنواع معيّنة من الطعام
[item, ...]	كائن	إعداد مُسبق للطعام.
food_preset_name	String	يجب ملء هذا الحقل. الاسم الداخلي للإعداد المسبق للطعام، والذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا الاسم غير سهل الاستخدام، وتتم مشاركته بين جميع اللغات.
supported_units	صفيف	يجب ملء هذا الحقل. يحتوي على جميع الوحدات التي يوفرها الجهاز لطعام معيّن.
[item, ...]	String	وحدة مسموح بها. القيم المسموح بها: 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	صفيف	يجب ملء هذا الحقل. مرادفات أسماء الطعام في الإعدادات المسبقة بكل لغة معتمَدة
[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، يُرجى الاطّلاع على تنفيذ النية.

الولايات	Type	الوصف
currentCookingMode	String	يجب ملء هذا الحقل. تصف هذه السمة وضع الطهي الحالي الذي تم ضبطه على الجهاز، من قائمة سمة supportedCookingModes. قد يتم الإبلاغ عن وضع واحد فقط. إذا لم يتم اختيار أي وضع حاليًا، يجب ضبط هذا الإعداد على "بدون".
currentFoodPreset	String	تصف إعداد الطعام الذي يتم طهيه حاليًا في الجهاز، من قائمة سمة foodPresets. قد يتم الإبلاغ عن طعام واحد فقط. إذا لم يتم اختيار أي طعام في الوقت الحالي، يجب ضبطه على "بدون".
currentFoodQuantity	Number	تحدّد هذه السمة الكمية الحالية من الطعام الذي يتم طهيه المرتبطة بالسمة currentFoodUnit، إذا تم تحديد الكمية. يجب عدم الإبلاغ عنها إذا لم يتم طهي أي شيء حاليًا، أو إذا لم تكن هناك كمية مرتبطة بهذا الإعداد المسبَق للطعام.
currentFoodUnit	String	الوحدة المرتبطة بالسمة currentFoodQuantity، من قائمة السمة supported_units.

أمثلة

هل الفرن يطهو؟

{
  "currentCookingMode": "BAKE"
}

ما هي المأكولات التي يتم طهيها في حلة الأرز الآن؟

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

مفاتيح الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة إلى الأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات عن التعامل مع أغراض EXECUTE، يُرجى الاطّلاع على تنفيذ النية.

action.devices.commands.Cook

بدء الطهي أو إيقافه

المَعلمات

المَعلمات	Type	الوصف
start	منطقية	يجب ملء هذا الحقل. اضغط على "true" لبدء الطهي، و"false" لإيقاف وضع الطهي الحالي.
cookingMode	String	تم طلب وضع الطهي للجهاز، من سمة supportedCookingModes.
foodPreset	String	تشير هذه السمة إلى اسم الإعداد المسبَق للطعام الذي طلبه المستخدم من سمة foodPresets.
quantity	Number	كمية الطعام التي يطلبها المستخدم.
unit	String	الوحدة المرتبطة بالسمة quantity، من supported_units

أمثلة

بدء الخَبْز في الفرن

{
  "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 - طلب المستخدم إعدادًا مسبقًا للطعام غير متوافق مع الجهاز.