스마트 홈 Cook Trait 스키마
action.devices.traits.Cook
- 이 특성은 다양한 음식 미리 설정 및 지원되는 요리 모드에 따라 음식을 조리할 수 있는 기기에 속합니다.
이러한 기기 유형의 예로는 멀티쿠커, 압력솥, 블렌더, 전자레인지가 있습니다. Cook 명령에는 음식의 수량과 이름이 포함될 수 있습니다(예: '현미 2컵', 여기서 '현미'는 기기의 미리 설정된 음식).
이 특성은 조리 시간 또는 조리 온도를 처리하지 않습니다. 자세한 내용은 타이머 및 TemperatureControl을 참고하세요.
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
supportedCookingModes |
배열 |
필수. 이 기기에서 지원되는 요리 모드 |
[item, ...] |
String |
요리 모드 지원 값:
|
foodPresets |
배열 |
특정 유형의 음식에 대한 미리 설정. |
[item, ...] |
객체 |
음식 미리 설정을 탭합니다. |
food_preset_name |
String |
필수. 명령어와 상태에서 사용될 음식 사전 설정의 내부 이름입니다. 이 이름은 사용자 친화적이지 않고 모든 언어로 공유됩니다. |
supported_units |
배열 |
필수. 특정 음식에 대해 기기에서 지원하는 모든 단위가 포함되어 있습니다. |
[item, ...] |
String |
지원되는 단위입니다. 지원 값:
|
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 |
필수.
|
currentFoodPreset |
String |
|
currentFoodQuantity |
Number |
수량이 지정된 경우 |
currentFoodUnit |
String |
|
예
오븐이 요리되고 있나요?
{ "currentCookingMode": "BAKE" }
지금 밥솥에서 어떤 요리를 해?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
기기 명령어
이 특성이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.Cook
요리를 시작하거나 중지합니다.
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
start |
Boolean |
필수. 요리를 시작하려면 true, 현재 요리 모드를 중지하려면 false입니다. |
cookingMode |
String |
|
foodPreset |
String |
|
quantity |
Number |
사용자가 요청한 음식의 양입니다. |
unit |
String |
|
예
오븐에서 베이킹을 시작합니다.
{ "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
: 사용자가 기기에서 지원하지 않는 음식 미리 설정을 요청했습니다.