スマートホーム インテントは、照明の点灯やスピーカーへのオーディオのキャストなど、実行する 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
インテントをフルフィルメントに送信し、クラウド インフラストラクチャからユーザーのデバイスと機能の初期リストを取得します。
ユーザーのアカウントのリンク解除と再リンクを回避するには、Assistant にリクエストの同期を送信します。これにより、action.devices.SYNC
インテントがフルフィルメントに送信され、デバイスと機能のリストが同期されます。詳細については、Request Sync を実装するをご覧ください。
ローカル フルフィルメントのセットアップ中に、ローカルホーム プラットフォームは smart home アクションのクラウド フルフィルメントからの SYNC
レスポンスをチェックします。ローカル フルフィルメントをサポートするように SYNC
レスポンスを変更する方法については、クラウド フルフィルメントで SYNC レスポンスを更新するをご覧ください。
クエリ
action.devices.QUERY
インテントは、smart home デバイスの現在の状態を照会するために使用します。
ユーザーがデバイスのステータスをクエリしているときに、「OK Google, キッチンでどのライトが点灯していますか?」などの質問に答えるとき。Assistant が action.devices.QUERY
インテントをフルフィルメントに送信します。
最適なユーザー エクスペリエンスを実現するには、Report State を実装して、ユーザーのデバイスの現在の状態を Google Home Graph に直接事前に報告する必要があります。たとえば、ユーザーが物理的な照明スイッチでスマートライトをオンにした場合、Assistant はそれを認識します。
EXECUTE
action.devices.EXECUTE
インテントは、smart home デバイスで実行するコマンドを提供するために使用します。
ユーザーが Assistant を使用してデバイスにコマンドを送信すると、フルフィルメントは、アクションと操作対象のデバイスを記述した action.devices.EXECUTE
インテントをフルフィルメントに送信します。ユーザーは、「OK Google, リビングルームの電気をつけて」などのコマンドでデバイスに対してアクションを実行できます。
接続解除
action.devices.DISCONNECT
インテントは、ユーザーがアプリ アカウントと Assistant のリンクを解除したことを通知するためにトリガーされます。action.devices.DISCONNECT
インテントを受け取った後は、このユーザーのデバイスの状態を報告しないでください。