طرح صفت آشپز خانه هوشمند

action.devices.traits.Cook - این ویژگی متعلق به دستگاه هایی است که می توانند غذا را مطابق از پیش تنظیم های مختلف غذا و حالت های پخت پشتیبانی شده بپزند.

نمونه هایی از این نوع دستگاه ها عبارتند از Multicooker , Pressure cooker , Blender و Microwave . دستورات آشپزی ممکن است شامل مقدار و نام غذا باشد، مانند "دو فنجان برنج قهوه ای"، که در آن "برنج قهوه ای" یک غذای از پیش تنظیم شده برای دستگاه است.

این ویژگی با زمان پخت یا دمای پخت و پز سازگاری ندارد. برای اطلاعات بیشتر به Timer and TemperatureControl مراجعه کنید.

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات 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 توصیف می کند. فقط یک حالت ممکن است گزارش شود. اگر در حال حاضر هیچ حالتی انتخاب نشده است، باید روی NONE تنظیم شود.
currentFoodPreset	رشته	food_preset_name پخت و پز فعلی غذا در دستگاه، از ویژگی foodPresets . فقط یک غذا ممکن است گزارش شود. اگر در حال حاضر هیچ غذایی انتخاب نشده است، باید روی NONE تنظیم شود.
currentFoodQuantity	شماره	اگر مقداری مشخص شده باشد، مقدار فعلی پخت غذا مرتبط با currentFoodUnit را تعریف می کند. اگر در حال حاضر چیزی در حال پختن نیست، یا اگر مقداری مرتبط با این غذا از پیش تنظیم نشده باشد، نباید گزارش شود.
currentFoodUnit	رشته	واحد مرتبط با currentFoodQuantity ، از لیست از پیش تعیین شده supported_units .

نمونه ها

آیا فر من در حال پختن است؟

{
  "currentCookingMode": "BAKE"
}

در حال حاضر در پلوپز من چه می پزم؟

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

دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

action.devices.commands.Cook

شروع یا متوقف کردن پخت و پز.

پارامترها

پارامترها	تایپ کنید	توضیحات
start	بولی	مورد نیاز. درست برای شروع پخت و پز، غلط برای توقف حالت پخت فعلی.
cookingMode	رشته	درخواست حالت پخت برای دستگاه، از ویژگی supportedCookingModes .
foodPreset	رشته	نام غذای از پیش تنظیم شده درخواست شده توسط کاربر، از ویژگی foodPresets .
quantity	شماره	مقدار غذای درخواستی کاربر.
unit	رشته	واحد مرتبط با quantity ، از ویژگی supported_units .

نمونه ها

شروع به پخت در فر من کنید.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "BAKE"
  }
}

پخت در فر من را متوقف کنید.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": false,
    "cookingMode": "BAKE"
  }
}

شروع به پختن 2 فنجان برنج سفید در پلوپز من کنید.

{
  "command": "action.devices.commands.Cook",
  "params": {
    "start": true,
    "cookingMode": "COOK",
    "foodPreset": "white_rice",
    "quantity": 2,
    "unit": "CUPS"
  }
}

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.

• deviceDoorOpen - درب دستگاه باز است.
• deviceLidOpen - درب دستگاه باز است.
• fractionalAmountNotSupported - کاربر مقدار کسری برای این غذای از پیش تنظیم شده درخواست کرده است، اما توسط این دستگاه پشتیبانی نمی شود.
• amountAboveLimit - کاربر مقداری را درخواست کرد که بیش از حداکثر بود.
• unknownFoodPreset - کاربر یک تنظیم از پیش تعیین شده غذایی را درخواست کرد که توسط دستگاه پشتیبانی نمی شود.