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

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

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

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

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

سمات الجهاز

قد تُبلِغ الأجهزة التي تستخدم هذه السمة عن السمات التالية كجزء من عملية 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"
        }
      ]
    }
  ]
}

حالات الجهاز

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

الولايات النوع الوصف
currentCookingMode سلسلة

إنّ هذه السمة مطلوبة.

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

currentFoodPreset سلسلة

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

currentFoodQuantity Number

تحدّد هذه المعلّمة مقدار طهي الطعام الحالي المرتبط بالسمة currentFoodUnit، إذا تم تحديد كمية. يجب عدم الإبلاغ عن حالة عدم وجود طهو حاليًا، أو في حال عدم توفّر كمية محدّدة مرتبطة بهذا الإعداد المسبق للطعام.

currentFoodUnit سلسلة

الوحدة المرتبطة بالسمة currentFoodQuantity من قائمة السمة supported_units

أمثلة

هل طهو الفرن؟

{
  "currentCookingMode": "BAKE"
}

ماذا يطبخ في فرن الأرز في الوقت الحالي؟

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

أوامر الجهاز

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

action.devices.commands.Cook

بَدْءْ أَوْ إِيقَافِ الطَّبْخْ.

المَعلمات

المَعلمات النوع الوصف
start منطقي

إنّ هذه السمة مطلوبة.

صحيح للبدء بالطهي، أو خطأ لإيقاف وضع الطهي الحالي.

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