סכימה של תכונות בישול לבית חכם

action.devices.traits.Cook – התכונה הזו שייכת למכשירים שיכולים לבשל מזון לפי הגדרות קבועות מראש של מזון ולפי מצבי בישול נתמכים.

דוגמאות לסוגי מכשירים אלה: Multicooker, Pressure cooker, Blender ו-Microwave. פקודות הבישול עשויות לכלול את הכמות והשם של למשל 'שתי כוסות של אורז חום', ו'אורז חום' היא הגדרה קבועה מראש של מזון עבור המכשיר.

התכונה הזו לא מטפלת בזמן הבישול או בטמפרטורת הבישול. צפייה בTimer ובTemperatureControl אפשר לקבל מידע נוסף.

מאפייני המכשיר

מכשירים עם התכונה הזו עשויים לדווח על הדברים הבאים כחלק מהפעולה SYNC. למידה מידע נוסף על טיפול בכוונות של SYNC: מילוי Intent.

מאפיינים	סוג	תיאור
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: מילוי Intent.

מדינות	סוג	תיאור
currentCookingMode	String	חובה. מיועד לתיאור של מצב הבישול הנוכחי שמוגדר במכשיר, מהמאפיין supportedCookingModes. ניתן לדווח רק על מצב אחד. אם לא נבחר מצב, יש להגדיר אותו כ-NONE.
currentFoodPreset	String	food_preset_name של בישול האוכל הנוכחי במכשיר, מהמאפיין foodPresets. ניתן לדווח רק על מזון אחד. אם לא נבחר כרגע אוכל, האפשרות הזו צריכה להיות מוגדרת כ-NONE.
currentFoodQuantity	מספר	הגדרת הכמות הנוכחית של בישול אוכל שמשויכת לcurrentFoodUnit, אם צוינה כמות. אין לדווח אם שום דבר לא מתבשל כרגע או אם אין כמות שמשויכת להגדרה מראש הזו של האוכל.
currentFoodUnit	String	היחידה שמשויכת ל-currentFoodQuantity, מרשימת supported_units של ההגדרות הקבועות מראש.

דוגמאות

האם התנור שלי מתבשל?

{
  "currentCookingMode": "BAKE"
}

מה מתבשל בסיר האורז שלי כרגע?

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

CommandS במכשיר

מכשירים עם התכונה הזו עשויים להגיב לבקשות הבאות פקודות כחלק מהפעולה EXECUTE. למידה מידע נוסף על טיפול בכוונות של EXECUTE: מילוי Intent.

action.devices.commands.Cook

מתחילים או מפסיקים לבשל.

פרמטרים

פרמטרים	סוג	תיאור
start	בוליאני	חובה. true כדי להתחיל לבשל, false כדי להפסיק את מצב הבישול הנוכחי.
cookingMode	String	נשלחה בקשה למצב בישול במכשיר, מהמאפיין supportedCookingModes.
foodPreset	String	שם ההגדרה הקבועה מראש של האוכל שהמשתמש ביקש, מהמאפיין foodPresets.
quantity	מספר	כמות המזון שהמשתמש ביקש.
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"
  }
}

אני רוצה להתחיל לבשל 2 כוסות של אורז לבן בסיר האורז שלי.

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

ERRORS במכשיר

ראה את הרשימה המלאה של שגיאות וחריגים.

• deviceDoorOpen – דלת המכשיר פתוחה.
• deviceLidOpen – מכסה המכשיר פתוח.
• fractionalAmountNotSupported – המשתמש ביקש סכום חלקי עבור הפריט הזה הגדרה קבועה מראש של מזון, אבל היא לא נתמכת במכשיר הזה.
• amountAboveLimit - המשתמש ביקש כמות גדולה מהמקסימום.
• unknownFoodPreset – המשתמש ביקש הגדרה קבועה מראש של מזון שלא נתמכת במכשיר.