スマートホームの Cook トレイトのスキーマ
action.devices.traits.Cook
- このトレイトは、さまざまなフード プリセットやサポートされている調理モードで食品を調理できるデバイスに使用します。
このようなデバイスタイプの例としては、Multicooker、Pressure cooker、Blender、Microwave などがあります。調理コマンドには、食品の量や名前を含めることができます(「2 カップの黒米」で、「黒米」はデバイスのフード プリセットです)。
このトレイトは調理時間や調理温度を処理しません。 詳しくは、Timer と 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 |
番号 |
数量が指定されている場合は、 |
currentFoodUnit |
文字列 |
|
例
オーブンは料理してる?
{ "currentCookingMode": "BAKE" }
今、炊飯器で何を調理してるの?
{ "currentCookingMode": "COOK", "currentFoodPreset": "brown_rice", "currentFoodQuantity": 2, "currentFoodUnit": "CUPS" }
デバイスのコマンド
このトレイトを持つデバイスは、EXECUTE
オペレーションの一部として次のコマンドに応答できます。EXECUTE
インテントの処理方法については、インテントのフルフィルメントをご覧ください。
action.devices.commands.Cook
調理を開始または停止する。
パラメータ
パラメータ | タイプ | 説明 |
---|---|---|
start |
ブール値 |
必須。 調理を開始する場合は true、現在の調理モードを停止する場合は false。 |
cookingMode |
文字列 |
|
foodPreset |
文字列 |
ユーザーがリクエストしたフード プリセットの名前( |
quantity |
番号 |
ユーザーが要求した食品の量。 |
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
- ユーザーがデバイスでサポートされていないフード プリセットを要求しました。