스마트 홈 Cook Trait 스키마

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, ...]	객체	음식 이름.
synonym	배열	필수사항. 사전설정의 동의어에는 단수형과 복수형이 모두 포함되어야 합니다(해당하는 경우).
[item, ...]	String	동의어 이름 사전 설정
lang	String	필수사항. 언어 코드입니다 (ISO 639-1). 지원되는 언어를 확인하세요.

예

요리 모드가 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 속성에서 가져옴) 하나의 음식만 보고할 수 있습니다. 현재 선택된 음식이 없으면 '없음'으로 설정되어야 합니다.
currentFoodQuantity	숫자	수량이 지정된 경우 currentFoodUnit와 연결된 현재 조리 중인 음식의 양을 정의합니다. 현재 조리 중인 항목이 없거나 이 음식 사전 설정과 연결된 수량이 없는 경우 보고해서는 안 됩니다.
currentFoodUnit	String	사전 설정의 supported_units 목록에서 currentFoodQuantity와 연결된 단위입니다.

예

오븐이 구워지고 있어?

{
  "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	supported_units 속성에서 quantity와 연결된 단위입니다.

예

오븐에서 베이킹을 시작해.

{
  "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 - 사용자가 기기에서 지원하지 않는 음식 사전 설정을 요청했습니다.