スマートホームの Cook トレイトのスキーマ
action.devices.traits.Cook
- このトレイトは、さまざまなフード プリセットやサポートされている料理モードに合わせて料理を実行できるデバイスに使用します。
たとえば、マルチクッカー、圧力鍋、ブレンダー、電子レンジなどがあります。調理コマンドには、食べ物の数量や名前を含めることができます(例: 「玄米 2 カップ」)。この場合、「玄米」がデバイスの食品事前設定です。
このトレイトは調理時間や調理温度に対応していません。 詳しくは、タイマーと TemperatureControl をご覧ください。
デバイスの属性
この特性を持つデバイスは、SYNC
オペレーションの一部として次の属性を報告する可能性があります。SYNC
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
属性 | タイプ | 説明 |
---|---|---|
supportedCookingModes |
配列 |
必須。 このデバイスでサポートされている調理モード。 |
[item, ...] |
文字列 |
調理モード。 サポートされている値:
|
foodPresets |
配列 |
特定の種類の食品のプリセット。 |
[item, ...] |
オブジェクト |
食べ物のプリセット。 |
food_preset_name |
文字列 |
必須。 フード プリセットの内部名。コマンドと状態で使用されます。この名前は使いやすくなく、すべての言語で共有されます。 |
supported_units |
配列 |
必須。 特定の食品についてデバイスがサポートしているすべての単位が含まれます。 |
[item, ...] |
文字列 |
サポートされている単位。 サポートされている値:
|
food_synonyms |
配列 |
必須。 サポートされている各言語での、プリセットのフード名の類義語。 |
[item, ...] |
オブジェクト |
料理名。 |
synonym |
配列 |
必須。 プリセットの類義語には、単数形と複数形の両方を含めます(該当する場合)。 |
[item, ...] |
文字列 |
同義語名。 |
lang |
文字列 |
必須。 言語コード(ISO 639-1)。サポートされている言語をご覧ください。 |
例
調理モードが 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 |
文字列 |
必須。
|
currentFoodPreset |
文字列 |
|
currentFoodQuantity |
Number |
数量が指定されている場合、 |
currentFoodUnit |
文字列 |
|
例
オーブンで料理できますか?
{ "currentCookingMode": "BAKE" }
現在、炊飯器でどんな料理をしている?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
デバイスのコマンド
この特性を持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理の詳細については、インテント フルフィルメントをご覧ください。
action.devices.commands.Cook
調理を開始または停止します。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
start |
ブール値 |
必須。 調理を開始する場合は true、現在の調理モードを停止する場合は false。 |
cookingMode |
文字列 |
「 |
foodPreset |
文字列 |
|
quantity |
Number |
ユーザーが要求した食品の量。 |
unit |
文字列 |
|
例
オーブンで焼き上がる
{ "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
- ユーザーがデバイスでサポートされていないフード プリセットを要求しました。