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

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