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

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"
        }
      ]
    }
  ]
}

מכשיר STATES

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

מדינות	סוג	תיאור
currentCookingMode	String	חובה. מתאר את מצב הבישול הנוכחי שהוגדר במכשיר, מרשימת המאפיין supportedCookingModes. ניתן לדווח על מצב אחד בלבד. אם לא נבחר מצב, צריך להגדיר את המצב כ'ללא'.
currentFoodPreset	String	מתאר את בישול האוכל הנוכחי במכשיר, מרשימת המאפיין foodPresets. ניתן לדווח על מנה אחת בלבד. אם לא נבחר כרגע אוכל, צריך להגדיר את הערך 'ללא'.
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 – המשתמש ביקש הגדרה קבועה מראש של אוכל שלא נתמכת במכשיר.