App Actions の組み込みインテント

組み込みインテント（BII）を使用すると、アプリでフルフィルメント機能を表現できます Google に送信されます。 shortcuts.xml ファイルで機能を宣言する インテント パラメータをフルフィルメントにマッピングすると、 Google アシスタントがユーザーの応答に応答して特定の画面でアプリを起動し、 ユーザーがタスクを完了できるようにします。

組み込みインテントは、アプリのカテゴリに応じてグループ化されています。各カテゴリは、ユーザーがアプリで頻繁に実行する一般的なタスクのセットを表しています。利用可能な BII の一覧とそのパラメータ、例 テストに使用できるクエリについては、組み込みインテントのリファレンスをご覧ください。

多くの BII には固有のデプロイ要件があり、 おすすめします。これらの要件と推奨事項は、アプリが 最適なエクスペリエンスをユーザーに提供できます

図 1. BII「START_EXERCISE」を音声で呼び出す アシスタントに話しかけます。
図 2. アプリを特定の画面で起動する START_EXERCISE タスクを開始します。
図 3. クエリに応じてウィジェットを表示します。

​

BII を実装してインテント パラメータを処理する

App Actions では、ケーパビリティを宣言して BII パラメータを処理する shortcuts.xml ファイルに指定します。BII を実装し、 次のとおりです。

  1. 選択した BII で capability を宣言します。
  2. 追加する BII フィールドごとに、ネストされた parameter 要素を追加します。
    1. targetClass または targetPackage を使用する場合は、これらを Android インテント extras を作成できます。
    2. ディープリンク URL を使用する場合は、クエリで名前付きパラメータを使用する URL テンプレートの文字列。

BII パラメータを処理するには、BII パラメータを capability 内の明示的 Android インテントの対応するパラメータ。 その後、その値をアプリで使用できます。お客様のアプリは BII パラメータ。ただし、「推奨」とマークされたデータ フィールドは、可能な限り処理する必要があります。 組み込みインテントのリファレンスをご覧ください。

インテント フルフィルメントを複数定義して、それぞれに独自のインテント セットを指定できます。 推奨パラメータ。商品タイプに応じて適切なフルフィルメントが ユーザーのクエリから識別されるケーパビリティ パラメータと、 指定することもできます。

たとえば、actions.intent.START_EXERCISE インテントが、アプリで BII パラメータ「exercise.name」を処理することを推奨していますが、 パラメータなしでアプリに BII を実装できます。 ユーザーのクエリを処理するために、特定のリソースへのアクセスを エクササイズ名（例: 「Example App にエクササイズの記録を開始するよう頼む」）。

「 次のスニペットには、必須パラメータのないフルフィルメントへのフォールバックが含まれています ユーザーのクエリにパラメータが含まれていない場合:

<?xml version="1.0" encoding="utf-8"?>
<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">

    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity1"
            android:targetPackage="com.example.myapplication">
            <parameter
                android:name="exercise.name"
                android:key="exerciseType"
                android:required="true"
                />
        </intent>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity2">
        </intent>
    </capability>
</shortcuts>

Google アシスタントは、ユーザーに最も関連性の高い情報を提供できるよう最善を尽くします ユーザーにパラメータ値を渡す必要があります。たとえば ユーザーのクエリは たとえば、Example Restaurant のモバイルアプリでピザを注文する場合、 あります。ユーザーの利便性を高めるため、アシスタントは緯度を提供することがあります そのアプリに最も近い Example Restaurant の経度値を取得しています。

追加の要件として、アプリが特定のサービスに対して ユーザーの実際の状態を変更するアクション（ 支払い、注文の確定、メッセージの送信など）を、 アクションを起こします

曖昧性除去

<url-parameter> またはインテント エクストラを介してアプリに渡される引数が、 一意に識別する ID を指定します。この例では 引数の値を検索引数として使用し、ユーザーを検索に誘導する クリックします。曖昧さを取り除き、適切な商品を選択できます。

たとえば、ユーザーのクエリが「Order from Example Restaurant」で、 BII ORDER_MENU_ITEM です。ユーザーにリストを提示すると、 名前が「"Example Restaurant"」と一致するレストラン。

言語とロケールのサポート

各 App Action BII による開発とテストでサポートされている言語 / 地域 組み込みインテントのリファレンスに記載されています。一部の BII は、 デベロッパー テストとアシスタントからのユーザーによるトリガーのための言語 / 地域サポート。