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

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

‫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, ...]`	الكائن	اسم الطعام يجب توفير عنصر واحد على الأقل بقيمة `lang` تساوي `en` من أجل توفير لغة احتياطية.
`synonym`	المصفوفة	مطلوبة مرادفات للإعداد المُسبَق، ويجب أن تتضمّن صيغتَي المفرد والجمع، إذا كان ذلك منطبقًا.
`[item, ...]`	String	اسم المرادف للإعداد المُسبَق يجب توفير عنصر واحد على الأقل بقيمة `lang` تساوي `en` من أجل توفير لغة احتياطية.
`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"
}

أوامر الجهاز

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

`action.devices.commands.Cook`

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

المعلمات

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