Smart Home Cook Trait 스키마

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

이러한 기기 유형의 예로는 Multicooker, Pressure cooker, Blender, Microwave가 있습니다. Cook 명령어에는 음식의 양과 이름이 포함될 수 있습니다(예: '현황 2컵'). 여기서 '현미'는 기기에 미리 설정된 음식입니다.

이 특성은 조리 시간이나 조리 온도를 처리하지 않습니다. 자세한 내용은 Timer 및 TemperatureControl를 참조하세요.

기기 ATTRIBUTES

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

특성	유형	설명
supportedCookingModes	배열	필수사항. 이 기기에서 지원하는 요리 모드입니다.
[item, ...]	문자열	요리 모드입니다. 지원되는 값: 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	문자열	필수사항. 명령 및 상태에서 사용되는 음식 사전 설정의 내부 이름입니다. 이 이름은 사용자 친화적이지 않을 수 있으며 모든 언어에서 공유됩니다.
supported_units	배열	필수사항. 기기에서 특정 음식에 대해 지원하는 모든 단위가 포함됩니다.
[item, ...]	문자열	지원되는 단위입니다. 지원되는 값: 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, ...]	문자열	사전 설정된 동의어 이름입니다.
lang	문자열	필수사항. 언어 코드 (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	문자열	필수사항. supportedCookingModes 속성 목록에서 기기에 설정된 현재 요리 모드를 설명합니다. 하나의 모드만 보고될 수 있습니다. 현재 선택된 모드가 없으면 NONE으로 설정되어야 합니다.
currentFoodPreset	문자열	foodPresets 속성 목록에서 기기의 현재 음식 요리를 설명합니다. 음식 1개만 신고할 수 있습니다. 현재 선택된 음식이 없는 경우 NONE으로 설정되어야 합니다.
currentFoodQuantity	Number	수량이 지정된 경우 currentFoodUnit와 연결된 현재 음식 요리의 양을 정의합니다. 현재 요리 중인 항목이 없거나 이 음식 사전 설정과 연결된 수량이 없는 경우 보고하면 안 됩니다.
currentFoodUnit	문자열	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	문자열	supportedCookingModes 속성에서 기기의 요리 모드가 요청되었습니다.
foodPreset	문자열	foodPresets 속성에서 사용자가 요청한 음식 사전 설정 이름입니다.
quantity	Number	사용자가 요청한 음식의 양입니다.
unit	문자열	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: 사용자가 기기에서 지원하지 않는 음식 사전 설정을 요청했습니다.