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