הסכימה של מאפיין הבישול בבית חכם

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, ראו ביצוע כוונות.

מדינות	סוג	תיאור
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"
  }
}

שגיאות במכשיר

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

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