스마트 홈 Cook Trait 스키마

action.devices.traits.Cook - 이 특성은 다양한 음식 사전 설정 및 지원되는 요리 모드에 따라 음식을 요리할 수 있는 기기에 속합니다.

이러한 기기 유형의 예로는 Multicooker, Pressure cooker, Blender, Microwave가 있습니다. '갈색 쌀 2컵'과 같이 음식의 수량과 이름을 포함할 수 있는 쿡 명령어는 '갈색 쌀'이 기기의 음식 사전 설정인 경우입니다.

이 트레잇은 조리 시간 또는 조리 온도를 처리하지 않습니다. 자세한 내용은 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)입니다. 지원되는 언어를 참고하세요.

예

조리 모드가 하나만 있고 사전 설정이 없는 기기

{
  "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	사전 설정의 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"
  }
}

기기 오류

오류 및 예외의 전체 목록을 참고하세요.

• deviceDoorOpen - 기기 문이 열려 있습니다.
• deviceLidOpen - 기기 덮개가 열려 있습니다.
• fractionalAmountNotSupported - 사용자가 이 음식 사전 설정에 소수점 이하 자릿수를 요청했지만 이 기기에서 지원되지 않습니다.
• amountAboveLimit - 사용자가 최대 수량을 초과하는 수량을 요청했습니다.
• unknownFoodPreset - 사용자가 기기에서 지원하지 않는 음식 사전 설정을 요청했습니다.