スマートホームの Cook トレイトのスキーマ

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）。サポートされている言語をご確認ください。

例

調理モードが 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 属性から、デバイスで設定されている現在の調理モードを表します。報告できるのは 1 つのモードのみです。モードが選択されていない場合は、NONE に設定する必要があります。
currentFoodPreset	String	デバイスで現在調理している食品の food_preset_name（foodPresets 属性から取得）。食品は 1 つのみ報告できます。現在食品が選択されていない場合は、NONE に設定する必要があります。
currentFoodQuantity	番号	数量が指定されている場合は、currentFoodUnit に関連付けられた現在の調理量を定義します。現在何も調理されていない場合、またはこのフード プリセットに関連付けられた数量がない場合は、報告されません。
currentFoodUnit	String	currentFoodQuantity に関連付けられた単位（プリセットの supported_units リストから選択）。

例

オーブンは使える？

{
  "currentCookingMode": "BAKE"
}

今、鍋で何を調理してるの？

{
  "currentCookingMode": "COOK",
  "currentFoodPreset": "brown_rice",
  "currentFoodQuantity": 2,
  "currentFoodUnit": "CUPS"
}

デバイスのコマンド

このトレイトを持つデバイスは、以下の動作に反応します。 コマンドを EXECUTE オペレーションの一部として使用できます。学習内容 EXECUTE インテントの処理の詳細については、以下をご覧ください。 インテント フルフィルメント。

action.devices.commands.Cook

調理を開始または停止する。

パラメータ

パラメータ	タイプ	説明
start	ブール値	必須。 調理を開始する場合は true、現在の調理モードを停止する場合は false。
cookingMode	String	supportedCookingModes 属性からリクエストされたデバイスの調理モード。
foodPreset	String	ユーザーがリクエストしたフード プリセットの名前（foodPresets 属性から取得）。
quantity	番号	ユーザーが要求した食品の量。
unit	String	quantity に関連付けられた単位（supported_units 属性から取得）。

例

オーブンで焼く。

{
  "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 - ユーザーがデバイスでサポートされていないフード プリセットを要求しました。