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

アシスタント用にコンテキストコンテンツを最適化する

Android 6.0 Marshmallow には、ユーザーがGoogle アシスタントなどのアシスタントアプリを介してアプリを操作できる新しい方法が導入されています。アシスタントは、ユーザーが現在のアクティビティのコンテキストに関連するアクションを取得するために表示できるトップレベルウィンドウです。取得できるアクションとしは、デバイス上の他のアプリへのディープリンクなどがあります。

アシスタントを起動するには、ホームボタンを長押しするか、キーフレーズを言います。これにより、コンテキストに関連するアクションを表示するウィンドウが最前面に開きます。

Google アシスタントなどのアシスタントアプリは、Now on Tap と呼ばれる機能を使用してアシスタントオーバーレイウィンドウを実装します。この機能は Android プラットフォームレベルの機能と連携します。これにより、ユーザーがアシスタントアプリを選択できるようになり、アシスタントアプリは、Android の Assist API を使用して Google アプリからコンテキスト情報を取得します。

このガイドでは、Android アプリが Android の Assist API を使用してアシスタントのユーザーエクスペリエンスを改善する方法について説明します。アシスタントで起動と操作を行えるようにメディアアプリを作成する方法については、Google アシスタントとメディアアプリをご覧ください。

アシスタントを使用する

アシスタントの標準的なユーザー操作を図 1 に示します。ユーザーがホームボタンを長押しすると、ソースアプリ内で Assist API コールバックが呼び出されます（ステップ 1）。アシスタントがオーバーレイウィンドウをレンダリングし（ステップ 2 と 3）、ユーザーが実行するアクションを選択します。アシスタントが、選択されたアクションを実行します。たとえば、レストランアプリ（デスティネーション）へのディープリンクを持つインテントをトリガーします（ステップ 4）。

図 1. Google アプリの Now on Tap 機能を使用したアシスタント操作の例

ユーザーは、[設定] > [アプリ] > [デフォルトアプリ] > [アシストと音声入力] を選択してアシスタントを構成できます。図 2 に示すように、画面コンテンツのテキストへのアクセス、スクリーンショットの使用などのシステムオプションを変更できます。

図 2. アシストと音声入力の設定

ソースアプリ

ユーザー補助に関するおすすめの方法に従うだけで、アプリでアシスタントをユーザーの情報源として使用できるようになります。ここでは、アシスタントのユーザーエクスペリエンスの向上や特別な処理を必要とするシナリオ（カスタムビューなど）の改善に役立つ追加情報を提供する方法について説明します。

追加情報をアシスタントと共有する

アプリは、テキストやスクリーンショット以外の情報もアシスタントと共有することができます。たとえば、音楽アプリの場合、現在のアルバム情報をアシスタントに渡すことで、アシスタントは現在のアクティビティに適したスマートなアクションを提案できるようになります。なお、Assist API ではメディアを操作できない点にご注意ください。メディアコントロールを追加するには、 Google アシスタントとメディアアプリをご覧ください。

アシスタントに追加情報を提供するには、図 3 に示すように、アプリでアプリリスナーを登録してグローバルアプリコンテキストを提供し、アクティビティコールバックを使ってアクティビティ固有の情報を提供します。

図 3. Assist API のライフサイクルシーケンス図

グローバルアプリコンテキストを提供するには、アプリは、Application.OnProvideAssistDataListener の実装を作成し、registerOnProvideAssistDataListener() を使用して登録します。アクティビティ固有のコンテキスト情報を提供するため、アクティビティは onProvideAssistData() と onProvideAssistContent() をオーバーライドします。 2 つのアクティビティメソッドは、オプションのグローバルコールバックが呼び出された後に呼び出されます。コールバックはメインスレッド上で実行されるため、すぐに完了します。コールバックはアクティビティが実行中のときにのみ呼び出されます。

コンテキストを提供する

ユーザーがアシスタントをアクティブにすると、onProvideAssistData() が呼び出され、AssistStructure のインスタンスとして表現される現在のアプリのコンテキストをすべて含む完全な ACTION_ASSIST インテントが作成されます。このメソッドをオーバーライドして、バンドル内に独自の情報を追加すると、アシストインテントの EXTRA_ASSIST_CONTEXT の部分に表示させることができます。

コンテンツについて説明する

アプリに onProvideAssistContent() を実装すると、現在のアクティビティに関するコンテンツ関連参照を提供できるようになり、アシスタントのユーザーエクスペリエンスを改善できます。JSON-LD オブジェクトを使用して Schema.org で定義されている共通語彙を使用して、アプリのコンテンツを記述できます。次の例では、ユーザーが現在参照している音楽アルバムを説明する構造化データが音楽アプリから提供されます。

Kotlin

override fun onProvideAssistContent(assistContent: AssistContent) {
    super.onProvideAssistContent(assistContent)

    val structuredJson: String = JSONObject()
            .put("@type", "MusicRecording")
            .put("@id", "https://example.com/music/recording")
            .put("name", "Album Title")
            .toString()

    assistContent.structuredData = structuredJson
}

Java

@Override
public void onProvideAssistContent(AssistContent assistContent) {
  super.onProvideAssistContent(assistContent);

  String structuredJson = new JSONObject()
       .put("@type", "MusicRecording")
       .put("@id", "https://example.com/music/recording")
       .put("name", "Album Title")
       .toString();

  assistContent.setStructuredData(structuredJson);
}

また、onProvideAssistContent() をカスタム実装することでユーザーエクスペリエンスを向上させることもできます。この方法には以下のようなメリットがあります。

提供されたコンテンツインテントを調整して、アクティビティにとって最も重要なコンテキストを適切に反映することができます。
表示されるコンテンツの URI を提供できます。
ユーザーが現在表示している、関心のある追加コンテンツを setClipData() に入力します。

注: テキスト選択のカスタム実装を使用するアプリは通常、onProvideAssistContent() を実装して setClipData() を呼び出す必要があります。

デフォルト実装

onProvideAssistData() と onProvideAssistContent() のいずれのコールバックも実装されていない場合でも、現在のウィンドウのセキュアフラグがオンになっていなければ、システムは処理を続行し、収集した情報を自動的にアシスタントに渡します。図 3 に示すように、システムは onProvideStructure() と onProvideVirtualStructure() のデフォルト実装を使用して、テキスト / ビュー階層の情報を収集します。ビューがカスタムテキスト描画を実装している場合は、setText(CharSequence) を呼び出すことで、onProvideStructure() をオーバーライドし、ユーザーに表示するテキストをアシスタントに提供できるようにします。

ほとんどの場合、ユーザー補助サポートを実装することで、アシスタントは、必要な情報を取得できるようになります。ユーザー補助サポートを実装する方法については、アプリのユーザー補助機能を強化するをご覧ください。たとえば、以下のようなベストプラクティスが記載されています。

android:contentDescription 属性を指定します。
カスタムビュー用に AccessibilityNodeInfo を設定します。
カスタム ViewGroup オブジェクトが正しく子を公開していることを確認します。

アシスタントの視聴回数を除外する

機密情報を扱う場合、アプリで WindowManager の FLAG_SECURE レイアウトパラメータを設定することで、現在のビューをアシスタントから除外できます。ダイアログを含め、アクティビティによって作成されたすべてのウィンドウに対して FLAG_SECURE を明示的に設定する必要があります。また、アプリは、setSecure() を使用することで、サーフェスをアシスタントの対象から除外することもできます。アシスタントからすべてのビューを除外するグローバル（アプリレベル）のメカニズムはありません。FLAG_SECURE によって Assist API コールバックの呼び出しが停止することはありません。FLAG_SECURE を使用するアクティビティは引き続き、このガイドで説明しているコールバックを使用して、明示的にアシスタントアプリに情報を提供することができます。

注: 企業アカウント（Android for Work）の場合、管理者は DevicePolicyManager API の setScreenCaptureDisabled() メソッドを使用して、仕事用プロファイルのアシスタントデータの収集を無効にできます。

音声操作

Assist API コールバックは、キーフレーズの検出時にも呼び出されます。詳細については、音声操作のドキュメントをご覧ください。

Z オーダーに関する注意事項

アシスタントは、現在のアクティビティの上に表示される軽量のオーバーレイウィンドウを使用します。ユーザーはいつでもアシスタントを起動できるため、図 4 に示すように、オーバーレイウィンドウの妨げになる永続的なシステムアラートウィンドウは作成しないでください。

図 4. アシストレイヤの Z オーダー

アプリでシステムアラートウィンドウを使用する場合は、速やかに削除してください。このウィンドウを画面上に表示したままにすると、ユーザーエクスペリエンスが低下します。

デスティネーションアプリ

アシスタントアプリは通常、リンク先のアプリを見つけるためにディープリンクを利用します。アプリをデスティネーションアプリとして選択できるようにするには、ディープリンクサポートを追加することをおすすめします。現在のユーザーコンテキストと、オーバーレイウィンドウに表示されるディープリンクなどの潜在的なアクション（図 1 のステップ 3 を参照）とのマッチングは、Google アシスタントの実装に固有のものです。たとえば、Google アシスタントアプリは、トラフィックをデスティネーションアプリに誘導するために、ディープリンクとアプリリンクを使用します。

独自のアシスタントを実装する

独自のアシスタントを実装することも可能です。図 2 に示すように、ユーザーは、アクティブにするアシスタントアプリを選択できます。こちらの VoiceInteraction サンプルに示すように、アシスタントアプリは、VoiceInteractionSessionService と VoiceInteractionSession を実装する必要があります。また、BIND_VOICE_INTERACTION パーミッションも必要です。アシスタントは、onHandleAssist() の AssistStructure のインスタンスとして表現されるテキスト / ビュー階層を受け取ることができます。onHandleScreenshot() を介してスクリーンショットを受け取ります。

アシスタント用にコンテキスト コンテンツを最適化する