Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。
コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

action.devices.traits.Cook - このトレイトは、さまざまなフード プリセットやサポートされている料理モードに合わせて料理を実行できるデバイスに使用します。

たとえば、マルチクッカー圧力鍋ブレンダー電子レンジなどがあります。調理コマンドには、食べ物の数量や名前を含めることができます(例: 「玄米 2 カップ」)。この場合、「玄米」がデバイスの食品事前設定です。

このトレイトは調理時間や調理温度に対応していません。 詳しくは、タイマーTemperatureControl をご覧ください。

デバイスの属性

この特性を持つデバイスは、SYNC オペレーションの一部として次の属性を報告する可能性があります。SYNC インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

属性 タイプ 説明
supportedCookingModes 配列

必須。

このデバイスでサポートされている調理モード。

[item, ...] 文字列

調理モード。

サポートされている値:

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 文字列

必須。

フード プリセットの内部名。コマンドと状態で使用されます。この名前は使いやすくなく、すべての言語で共有されます。

supported_units 配列

必須。

特定の食品についてデバイスがサポートしているすべての単位が含まれます。

[item, ...] 文字列

サポートされている単位。

サポートされている値:

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, ...] 文字列

同義語名。

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 文字列

必須。

supportedCookingModes 属性のリストで、デバイスで設定されている現在の調理モードを示します。報告されるモードは 1 つだけです。現在モードが選択されていない場合は、これを NONE に設定する必要があります。

currentFoodPreset 文字列

foodPresets 属性のリストで、デバイスで現在使用されている食品の料理を記述します。食品は 1 つのみ報告できます。食品が選択されていない場合は、NONE に設定する必要があります。

currentFoodQuantity Number

数量が指定されている場合、currentFoodUnit に関連する現在の料理の調理量を定義します。調理中である場合や、この食品プリセットに関連付けられた数量がない場合は、報告しないでください。

currentFoodUnit 文字列

supported_units 属性のリストにある currentFoodQuantity に関連付けられている単位。

オーブンで料理できますか?

{
  "currentCookingMode": "BAKE"
}

現在、炊飯器でどんな料理をしている?

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

デバイスのコマンド

この特性を持つデバイスは、EXECUTE オペレーションの一部として次のコマンドに応答できます。EXECUTE インテントの処理の詳細については、インテント フルフィルメントをご覧ください。

action.devices.commands.Cook

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

パラメータ

パラメータ タイプ 説明
start ブール値

必須。

調理を開始する場合は true、現在の調理モードを停止する場合は false。

cookingMode 文字列

supportedCookingModes」属性から、リクエストされたデバイスの調理モード。

foodPreset 文字列

foodPresets 属性から取得した、ユーザーがリクエストした食品プリセットの名前。

quantity Number

ユーザーが要求した食品の量。

unit 文字列

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