مخطط سمات الطهي الذكي في المنزل

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

وتشمل الأمثلة على هذه الأنواع من الأجهزة جهاز الطهو المتعدّد وجهاز طهي بالضغط والخلاط والموجات الصغرية. قد تتضمن أوامر الطهي كمية الطعام واسمه، مثل "كوبَين من الأرز البني"، حيث يكون "الأرز البني" إعدادًا مسبقًا للطعام مخصصًا للجهاز.

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

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
supportedCookingModes	المصفوفة	مطلوبة. أوضاع الطهي المتوافقة مع هذا الجهاز.
[item, ...]	سلسلة	وضع الطهي. القيم المسموح بها: 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	سلسلة	مطلوبة. الاسم الداخلي للإعداد المسبق للطعام، والذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا الاسم غير سهل الاستخدام، وتتم مشاركته عبر جميع اللغات.
supported_units	المصفوفة	مطلوبة. يحتوي على جميع الوحدات التي يدعمها الجهاز في نوع معين من الطعام.
[item, ...]	سلسلة	الوحدة المتوافقة. القيم المسموح بها: 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, ...]	سلسلة	اسم المرادفات مسبقة الإعداد.
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	سلسلة	مطلوبة. يصف هذا الإعداد وضع الطهي الحالي الذي تم ضبطه على الجهاز من قائمة السمة supportedCookingModes. يمكن الإبلاغ عن وضع واحد فقط. إذا لم يتم اختيار أي وضع حاليًا، يجب ضبط هذا الوضع على "بدون".
currentFoodPreset	سلسلة	يصف هذا الحقل الطهي الحالي للطعام في الجهاز من قائمة السمات foodPresets. ويمكن الإبلاغ عن طعام واحد فقط. إذا لم يتم تحديد أي طعام في الوقت الحالي، يجب تعيين هذا الإعداد على "بدون".
currentFoodQuantity	Number	تحدّد مقدار الطهي الحالي للطعام المرتبط بـ currentFoodUnit، إذا تم تحديد كمية. يجب عدم الإبلاغ عن أي محتوى ينفد حاليًا عند طهي الطعام أو إذا لم تكن هناك كمية مرتبطة بهذا الإعداد المسبق للطعام.
currentFoodUnit	سلسلة	الوحدة المرتبطة بالسمة currentFoodQuantity، من قائمة السمة supported_units.

أمثلة

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

{
  "currentCookingMode": "BAKE"
}

ماذا يطهو في فرن الأرز الآن؟

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

مفاتيح COMMAND

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

action.devices.commands.Cook

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

المَعلمات

المَعلمات	النوع	الوصف
start	منطقي	مطلوبة. True لبدء الطهي أو على "false" لإيقاف وضع الطهي الحالي.
cookingMode	سلسلة	تم طلب وضع الطهي للجهاز من السمة supportedCookingModes.
foodPreset	سلسلة	اسم الإعداد المسبق للطعام الذي طلبه المستخدم، من السمة foodPresets.
quantity	Number	كمية الطعام التي يطلبها المستخدم.
unit	سلسلة	الوحدة المرتبطة بالسمة 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 - طلب المستخدم إعداد طعام مسبقًا لا يتيحه الجهاز.