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

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

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

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

سمات الجهاز

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

السمات	النوع	الوصف
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، يمكنك الاطّلاع على تلبية الأهداف.

الولايات	النوع	الوصف
currentCookingMode	String	يجب ملء هذا الحقل. يصف وضع الطهي الحالي الذي تم ضبطه على الجهاز، من السمة supportedCookingModes. يمكن الإبلاغ عن وضع واحد فقط. إذا لم يتم اختيار أي وضع حاليًا، يجب ضبط هذا الخيار على "بدون".
currentFoodPreset	String	food_preset_name للطعام الذي يتم طهيه حاليًا في الجهاز، من سمة foodPresets يمكن الإبلاغ عن طعام واحد فقط. إذا لم يتم اختيار أي طعام حاليًا، يجب ضبط القيمة على NONE.
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

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

المعلمات

المعلمات	النوع	الوصف
start	صحيح/خطأ	مطلوبة صحيح لبدء الطهي، خطأ لإيقاف وضع الطهي الحالي
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 - طلب المستخدم إعدادًا مسبقًا للطعام غير متوافق مع الجهاز.