ברוכים הבאים למרכז למפתחים של 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`	מספר	מגדיר את הכמות הנוכחית של האוכל שמתבשל שמשויכת ל-`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	חובה. ‫True כדי להתחיל לבשל, ‫False כדי להפסיק את מצב הבישול הנוכחי.
`cookingMode`	String	מצב הבישול המבוקש במכשיר, ממאפיין `supportedCookingModes`.
`foodPreset`	String	השם של הגדרת ברירת המחדל של המזון שביקש המשתמש, ממאפיין `foodPresets`.
`quantity`	מספר	כמות המזון שהמשתמש ביקש.
`unit`	String	היחידה שמשויכת ל`quantity`, ממאפיין `supported_units`.

דוגמאות

Start baking in my oven (התחלת אפייה בתנור שלי).

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

Stop baking in my oven.

{
  "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 – המשתמש ביקש הגדרת אוכל קבועה מראש שלא נתמכת במכשיר.