스마트 홈 요리 특성 스키마

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, ...]`	객체	음식 이름입니다. 언어 대체 기능을 제공하려면 `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	`foodPresets` 속성에서 가져온 기기에서 현재 조리 중인 음식의 `food_preset_name`입니다. 음식은 하나만 신고할 수 있습니다. 현재 선택된 음식이 없는 경우 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 - 사용자가 기기에서 지원하지 않는 음식 사전 설정을 요청했습니다.