مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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