インテント

スマートホーム インテントは、照明の点灯、スピーカーへの音声のキャストなど、実行する smart home アクションを記述するシンプルなメッセージ オブジェクトです。

すべての smart home インテントは action.devices 名前空間に含まれており、フルフィルメントを提供する必要があります。Google Assistant がインテントをフルフィルメントに送信するたびに、ユーザーのサードパーティ OAuth 2 アクセス トークンが Authorization ヘッダーで渡されます。

サポートされている smart home インテントは次のとおりです。

SYNC

action.devices.SYNC インテントは、ユーザーが接続していて使用可能な smart home デバイスのリストをリクエストするために使用されます。

ユーザーが Google Home app (GHA) でデバイスをセットアップすると、クラウド インフラストラクチャに対する認証も行われます。その後、Assistant は OAuth2 トークンを受け取ります。この時点で、Assistantaction.devices.SYNC インテントをフルフィルメントに送信して、ユーザーのデバイスと機能の初期リストをクラウド インフラストラクチャから取得します。

この図は、Google インフラストラクチャとパートナー インフラストラクチャ間のデータのやり取りを示しています。Google インフラストラクチャから、アシスタント クライアント アプリで使用できるパートナーのリストがパートナー インフラストラクチャに渡されて、OAuth 認証が行われます。パートナー側の OAuth 認証は、パートナー セットアップ WebView、OAuth WebView、オプションの設定と期間、パートナー クラウド サービスです。認証が完了すると、パートナー インフラストラクチャからアシスタント クライアント アプリに OAuth 認証情報が返されます。パートナー クラウド サービスから、使用可能なデバイスと機能がアシスタント サービスに送信され、その情報がホームグラフに保存されます。
図 1: Google とパートナー インフラストラクチャ間のやり取り

ユーザー アカウントのリンク解除と再リンクを回避するには、リクエスト同期を Assistant に送信します。これにより、action.devices.SYNC インテントがフルフィルメントに送信され、デバイスと機能のリストが同期されます。詳細については、Request Sync の実装をご覧ください。

SYNC インテントのフロー図
図 2: SYNC インテント

ローカル フルフィルメントの設定時に、ローカルホーム プラットフォームは smart home アクションのクラウド フルフィルメントからの SYNC レスポンスを確認します。ローカル フルフィルメントをサポートするように SYNC レスポンスを変更する方法については、クラウド フルフィルメントで SYNC レスポンスを更新するをご覧ください。

クエリ

action.devices.QUERY インテントは、smart home デバイスの現在の状態を照会するために使用されます。

ユーザーがデバイスのステータスについて問い合わせてきた場合に、「OK Google, キッチンで点灯しているライトは?」などの質問に答えるには、Assistantaction.devices.QUERY インテントをフルフィルメントに送信します。

QUERY インテントのフロー図
図 3: クエリ インテント

最適なユーザー エクスペリエンスを実現するには、Report State を実装して、ユーザーのデバイスの現在の状態を事前に Google Home Graph に直接報告する必要があります。たとえば、ユーザーが物理的なライトスイッチでスマートライトをつけたかどうかを Assistant は把握できるようになります。

Report State を使用してデバイスの状態を報告する
図 4: デバイスの状態を報告する

EXECUTE

action.devices.EXECUTE インテントは、smart home デバイスで実行するコマンドを提供するために使用されます。

ユーザーが Assistant でデバイスにコマンドを送信すると、フルフィルメントは、アクションと対象のデバイスを記述した action.devices.EXECUTE インテントをフルフィルメントに対して受け取ります。「OK Google, リビングルームの電気をつけて」などのコマンドで、デバイスでアクションを実行できます。

EXECUTE インテントのフロー図
図 5: EXECUTE インテント

接続解除

action.devices.DISCONNECT インテントは、ユーザーが Assistant からアプリ アカウントのリンクを解除したことを知らせるためにトリガーされます。action.devices.DISCONNECT インテントを受け取った後は、このユーザーのデバイスの状態を報告しないでください。