스마트 홈 Cook Trait 스키마

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

이러한 기기 유형의 예로는 멀티쿠커, 압력솥, 블렌더, 전자레인지가 있습니다. Cook 명령에는 음식의 수량과 이름이 포함될 수 있습니다(예: '현미 2컵', 여기서 '현미'는 기기의 미리 설정된 음식).

이 특성은 조리 시간 또는 조리 온도를 처리하지 않습니다. 자세한 내용은 타이머 및 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 속성 목록에서 기기에 설정된 현재 요리 모드를 설명합니다. 하나의 모드만 신고할 수 있습니다. 현재 모드를 선택하지 않으면 '없음'으로 설정해야 합니다.
currentFoodPreset	String	foodPresets 속성 목록에서 기기의 현재 음식에 관해 설명합니다. 음식 1개만 신고할 수 있습니다. 현재 선택된 음식이 없는 경우 '없음'으로 설정해야 합니다.
currentFoodQuantity	Number	수량이 지정된 경우 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	Number	사용자가 요청한 음식의 양입니다.
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: 사용자가 기기에서 지원하지 않는 음식 미리 설정을 요청했습니다.