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

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

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

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

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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. يمكن الإبلاغ عن وضع واحد فقط. إذا لم يتم اختيار أي وضع حاليًا، يجب ضبطه على NONE.

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"
}

CommandS للجهاز

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