インテント

スマートホーム インテントは、Google Cloud 内で記述されている smart home 照明の点灯や、 オーディオをスピーカーにキャストできます。

smart home 個のインテントがすべて action.devices 名前空間であり、それらの名前空間に対するフルフィルメントを指定する必要があります。いつ Google Assistant がフルフィルメントにインテントを送信します。 Authorization ヘッダーで渡されます。

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

SYNC

action.devices.SYNC インテントは、指定された IP アドレスのリストをリクエストし、 ユーザーがすでに接続している smart home 台のデバイス 使用できます。

ユーザーが Google Home app (GHA) でデバイスをセットアップすると、 認証を受ける必要があります。その後、 Assistant が OAuth2 トークンを受け取ります。この時点で Assistant が action.devices.SYNC インテントを フルフィルメントを使用して、ユーザーのデバイスと機能の初期リストを 一元管理できます。

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

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

<ph type="x-smartling-placeholder">
</ph> SYNC インテントのフロー図
図 2: SYNC インテント

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

QUERY

action.devices.QUERY インテントを使用して現在の状態を照会する /smart home 台のデバイス。

ユーザーがデバイスのステータスをクエリしているときに、 OK Google, キッチンの電気は何に点灯している？, Assistant が action.devices.QUERY インテントを 受け取ります

<ph type="x-smartling-placeholder">
</ph> QUERY インテントのフロー図
図 3: QUERY インテント

最良のユーザー エクスペリエンスを実現するには、 Report State を使用して、事前に報告します。 ユーザーのデバイスの現在の状態を Google Home Graph。たとえば、これにより Assistant は、ユーザーがスマートライトを 物理的な照明スイッチです。

<ph type="x-smartling-placeholder">
</ph> Report State を使用してデバイスの状態を報告する
図 4: デバイスの状態を報告する

EXECUTE

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

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

<ph type="x-smartling-placeholder">
</ph> EXECUTE インテントのフロー図
図 5: EXECUTE インテント

DISCONNECT

action.devices.DISCONNECT インテントがトリガーされて通知が送信されます。 ユーザーが Assistant からアプリ アカウントのリンクを解除したとき。 action.devices.DISCONNECT インテントを受け取った後は、報告しないでください。 ステータスが表示されます。

前へ
Device types and traits
次へ
Fulfillment