スマートホーム インテントは、照明の点灯やスピーカーへのオーディオのキャストなど、実行する 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 トークンを受け取ります。この時点で、Assistant は action.devices.SYNC
インテントをフルフィルメントに送信し、クラウド インフラストラクチャからユーザーのデバイスと機能の初期リストを取得します。
![この図は、Google インフラストラクチャとパートナー インフラストラクチャ間のデータのやり取りを示しています。Google インフラストラクチャから、アシスタント クライアント アプリで使用できるパートナーのリストがパートナー インフラストラクチャに渡されて、OAuth 認証が行われます。パートナー側の OAuth 認証は、パートナー セットアップ WebView、OAuth WebView、オプションの設定と期間、パートナー クラウド サービスです。認証が完了すると、パートナー インフラストラクチャからアシスタント クライアント アプリに OAuth 認証情報が返されます。パートナー クラウド サービスから、使用可能なデバイスと機能がアシスタント サービスに送信され、その情報がホームグラフに保存されます。](https://cdn.statically.io/img/developers.home.google.com/static/cloud-to-cloud/primer/images/smarthome001.png?hl=ja)
ユーザーのアカウントのリンク解除と再リンクを回避するには、Assistant にリクエストの同期を送信します。これにより、action.devices.SYNC
インテントがフルフィルメントに送信され、デバイスと機能のリストが同期されます。詳細については、Request Sync を実装するをご覧ください。
![SYNC インテントのフロー図](https://cdn.statically.io/img/developers.home.google.com/static/cloud-to-cloud/primer/images/smarthome002.png?hl=ja)
ローカル フルフィルメントのセットアップ中に、ローカルホーム プラットフォームは smart home アクションのクラウド フルフィルメントからの SYNC
レスポンスをチェックします。ローカル フルフィルメントをサポートするように SYNC
レスポンスを変更する方法については、クラウド フルフィルメントで SYNC レスポンスを更新するをご覧ください。
クエリ
action.devices.QUERY
インテントは、smart home デバイスの現在の状態を照会するために使用します。
ユーザーがデバイスのステータスをクエリしているときに、「OK Google, キッチンでどのライトが点灯していますか?」などの質問に答えるとき。Assistant が action.devices.QUERY
インテントをフルフィルメントに送信します。
![QUERY インテントのフロー図](https://cdn.statically.io/img/developers.home.google.com/static/cloud-to-cloud/primer/images/query-diagram.png?hl=ja)
最適なユーザー エクスペリエンスを実現するには、Report State を実装して、ユーザーのデバイスの現在の状態を Google Home Graph に直接事前に報告する必要があります。たとえば、ユーザーが物理的な照明スイッチでスマートライトをオンにした場合、Assistant はそれを認識します。
![Report State を使用してデバイスの状態を報告する](https://cdn.statically.io/img/developers.home.google.com/static/cloud-to-cloud/primer/images/smarthome004.png?hl=ja)
EXECUTE
action.devices.EXECUTE
インテントは、smart home デバイスで実行するコマンドを提供するために使用します。
ユーザーが Assistant を使用してデバイスにコマンドを送信すると、フルフィルメントは、アク��ョンと操作対象のデバイスを記述した action.devices.EXECUTE
インテントをフルフィルメントに送信します。ユーザーは、「OK Google, リビングルームの電気をつけて」などのコマンドでデバイスに対してアクションを実行できます。
![EXECUTE インテントのフロー図](https://cdn.statically.io/img/developers.home.google.com/static/cloud-to-cloud/primer/images/smarthome003.png?hl=ja)
接続解除
action.devices.DISCONNECT
インテントは、ユーザーがアプリ アカウントと Assistant のリンクを解除したことを通知するためにトリガーされます。action.devices.DISCONNECT
インテントを受け取����後���、このユーザーのデバイスの状態を報告しないでください。