Google Home デベロッパー センターにようこそ。スマートホーム アクションの開発方法を学ぶことができます。注: アクションの作成は、引き続き Actions Console で行います。

ホームグラフ

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

スマートホーム アクションは、Google Home Graph を利用して、家とそのデバイスに関するコンテキスト データを保存、提供するデータベースです。Home Graph データベースには、ストラクチャ(自宅やオフィスなど)、部屋(寝室やリビングルームなど)、デバイス(スピーカーや電球など)に関する情報が格納されます。たとえば、Home Graph には、照明、テレビ、スピーカーなど、さまざまなメーカーのさまざまなタイプのデバイスを含むリビングルームがある家の概念を保存できます。この情報は、適切なコンテキストに基づいてユーザー リクエストを実行するために、Google Assistant で使用できます。電球がオンであるなどの状態データは、長期的に保存されません。エフェメラルであり、Home Graph でのみ使用されます。

Home Graph は基本的に、家の論理的な地図です。Assistant との自然な会話が可能です。書斎に座って照明を消したいときは、「OK Google, 電気を消して」と話しかけるだけで、現在どの部屋にいるかを伝える必要はありません。

Home Graph のメリット:

  • 暗黙的に指示ができる。Google Home デバイス、ライトが同じ部屋にある。「ライトを点けて」というだけで済みます。ライトが置かれている部屋を指定する必要はありません。
  • 特定の対象を制御できる。他の部屋にいるときでも、キッチンのライトを消すことができます。複数のメーカーのライトが混在していても問題ありません。smart home インテントは、Home Graph で識別される特定の会議室について判断されます。

構造

Google Home app (GHA) を使用すると、ユーザーは複数の構造を指定して、複数の家を管理できます。各構造には、それぞれ固有の部屋とデバイスがあります。構造は以下から構成されます。

  • 管理者 - 構造の所有者のアカウント。構造ごとに 1 人以上の管理者が必要です。マネージャーをいったん定義すると、他のユーザーとのストラクチャの共有や共有の停止を行えます。
  • 部屋 - 構造の一部である部屋。
  • ラベル - 「ジョンの家」などの構造を識別するラベル。
  • デバイス - 構造の一部であるデバイス。複数のメーカー製のデバイスが混在していてもかまいません。

図 1 に、構造、3 つの部屋、複数のデバイスを含むサンプルの家を示します。

この図はホームグラフの例を示しています。青い点線で囲まれた 1 つの構造に、オレンジ色の線で囲まれた 3 つの部屋があり、各部屋に置かれたデバイスが緑色の円で示されています。
図 1: ホームグラフのサンプル

Rooms

部屋は構造に属し、次のもので構成されています。

  • ラベル - 「寝室」など、部屋を識別するラベル。
  • デバイス - 部屋の一部であるデバイス。複数のメーカー製のデバイスが混在していてもかまいません。

デバイス

デバイスは少なくとも 1 つの構造に属する必要があり、最大で 1 つの部屋に属することができます。デバイスには次のプロパティがあります。

  • [タイプ] - 照明、カメラ、エアコンなど、デバイスの種類。
  • トレイト - デバイスがサポートするトレイトの種類。トレイトはデバイスごとに異なります。たとえば、照明には BrightnessColorSetting などのトレイトがあります。

トレイト

トレイトには次のプロパティがあります。

  • 属性 - デバイス属性のうち、デバイスにとって静的なものをいいます。属性には、温度の単位やモードなどがあります。
  • 状態 - デバイスの状態。ランプは、その特定のランプの現在の明るさを示す明るさの状態を返すことができます。デバイスのトレイトごとに、さまざまなデバイス状態がデバイスに追加されます。
  • ラベル - 「寝室のランプ」など、デバイスを識別するラベル。