스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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