このページは Cloud Translation API によって翻訳されました。

フォアグラウンドアプリの呼び出し

App Actions を使用すると、ユーザーは Google アシスタントに話しかけて、特定のタスクに直接移動できますユーザーが「OK Google, 配車を依頼して」 サンプルアプリ」フォアグラウンドアプリ呼び出しを使用すると、ユーザーがすでにアプリを開いている場合のエクスペリエンスをさらに向上させることができます。

フォアグラウンドアプリ呼び出しを使用すると、組み込みインテント（BII）を特定のアクティビティが使用します。

たとえば、ユーザーがライドシェアアプリをフォアグラウンドで実行し、Google アシスタントに「マウンテンビューへの乗車を予約して」と話しかけるか入力したとします。アプリは、この入力を使用して、目的地フィールドをマウンテンビューに設定します。こうしてユーザーがこう言ったり、「SFO から配車を注文して」と検索しアプリの状態を維持したままで、

制限事項

フォアグラウンドアプリ呼び出しは、次の BII でのみ使用できます。

ロケールのサポートと、特定の BII のフォアグラウンドアプリ呼び出しに関連するサンプルクエリについては、組み込みインテントリファレンスをご覧ください。

フォアグラウンドアプリ呼び出しをサポートする

フォアグラウンドアプリ呼び出しに対するサポートを追加するには、目的のフォアグラウンドアクティビティに基づいて、フルフィルメントの動作を追加します。目的のアクティビティがフォアグラウンドで実行されているときに App Action が呼び出されると、アシスタントはそのアクティビティにフラグを追加してディープリンクインテントを渡し、アプリがその状態を更新できるようにします。

BII のフォアグラウンドアプリ呼び出しを実装する手順は次のとおりです。

shortcuts.xml ファイルで、<intent> タグを BII に追加します。フォアグラウンドアプリの呼び出しをサポートする <capability>。
<intent> タグ内に <extra> タグを追加します。
<extra> タグで、android:key を "requiredForegroundActivity" に設定し、android:value を、フォアグラウンドで実行する必要があるアクティビティに設定します。クラスなしでアクティビティを指定する（アプリのパッケージ名に続けてスラッシュ（/）を付けたもの）その後にアクティビティ名 APP_PACKAGE_NAME/ACTIVITY_NAME を続けます。
"requiredForegroundActivity" に指定したフォアグラウンドアクティビティで、SINGLE_TOP フラグが設定されたディープリンクインテントを処理する onNewIntent() メソッドを実装します。指定したアクティビティがフォアグラウンドで実行されているとき、アシスタントは、このフラグを含むディープリンクインテントをフルフィルメントとして渡します。
onNewIntent() の呼び出しをフォアグラウンドアクティビティに対する更新として扱い、ディープリンクから抽出されたパラメータを使用して、そのアクティビティ内で状態を管理します。

で確認できます。

アプリでルーターアクティビティを使用して、すべての外部ディープリンクがルーターアクティビティの詳細については、以下をご覧ください。ルーターのアクティビティを処理する

例

サンプル shortcuts.xml ファイルからの以下のスニペットは、 requiredForegroundActivity 属性:

  <capability name="actions.intent.CREATE_TAXI_RESERVATION">
      <!-- Trigger with foreground app invocation if MainActivity is in the foreground. -->
      <intent
          android:targetClass="com.example.app.MainActivity"
          android:targetPackage="com.example.app">
          <parameter
              android:name="taxiReservation.dropoffLocation.name"
              android:key="dropoff" />
          <extra
              android:key="requiredForegroundActivity"
              android:value="com.example.app/com.example.app.MainActivity" />
      </intent>
      <!-- This won't trigger if MainActivity is in the foreground. -->
      <intent
          android:targetClass="com.example.app.MainActivity"
          android:targetPackage="com.example.app">
          <parameter
              android:name="taxiReservation.dropoffLocation.name"
              android:key="dropoff" />
      </intent>
  </capability>

ユーザー権限

フォアグラウンドアプリ呼び出しが機能するには、ユーザーがデバイス設定で [画面のテキストを使用] を有効にする必要があります。

フォアグラウンドアプリの呼び出しをユーザーが機能させるには、ユーザーが以下を行う必要があります。 [画面のテキストを使用] デバイス設定が有効になっている。この設定の場所と正確な名前は、OEM とデバイスメーカーによって異なります。たとえば、ユーザーのデバイスでは、このデバイス設定が [画面のコンテキストを使用] と呼ばれている場合があります。

Google Pixel でこの Android 設定にアクセスするには、まず [設定] >アプリと通知 >デフォルトのアプリ >Assist アプリ。次に、[アシストと音声] で入力画面で [画面のテキストを使用] を有効にします。

呼び出しをテストする

フォアグラウンドアプリの呼び出しを試すには、以下の手順を行います。

ユーザー権限セクションの手順に沿って、デバイス設定で [画面のテキストを使用] を有効にします。
アプリを開き、必要なフォアグラウンドアクティビティとしてリストしたアクティビティにアクセスします。
& を押すホームボタンを長押しして、現在の画面上にオーバーレイとしてアシスタントを開く。実装した BII に対応するクエリを指定してくださいアプリ名を記載する必要はありません問題がなければ、アプリは状態を維持したままで、アクティビティを再起動することなく、クエリに基づいて自動的に更新されます。

ルーターアクティビティを処理する

一部のアプリは、単一のゲートキーピングルーターアクティビティを使用して、すべての外部ディープリンクを処理します。ルーターアクティビティは、適切なビジネスロジックアクティビティを（なんらかのチェックと検証を行った後で）開始し、ビジネスロジックアクティビティをフォアグラウンドに戻します。

ディープリンクをトリガーすると、ルーターのアクティビティがタスクスタック、フォアグラウンドアクティビティの上にあります。ルーターアクティビティを使用するアプリでは、ルーターアクティビティが、Google アシスタントから送信されたインテントを、現在のフォアグラウンドアクティビティインスタンスに配信する必要があります。この要件を満たす方法は、ルーターアクティビティが開始される場所によって異なります。

ルーターがビジネスロジックアクティビティと同じタスクスタックで開始される場合は、SINGLE_TOP、CLEAR_TOP、NEW_TASK のビット演算 OR を使用してインテントを転送します。

Kotlin

Intent.FLAG_ACTIVITY_SINGLE_TOP or Intent.FLAG_ACTIVITY_CLEAR_TOP or Intent.FLAG_ACTIVITY_NEW_TASK

Java

Intent.FLAG_ACTIVITY_SINGLE_TOP | Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_NEW_TASK

ルーターがビジネスロジックとは別のタスクスタックで開始される場合アクティビティの場合は、SINGLE_TOP フラグを使用してインテントをビジネスに転送します。ロジックアクティビティを使用します。