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

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

Android 6.0 Marshmallow では、ユーザーが Google アシスタントなどのアシスタントアプリを使ってアプリを操作する新しい方法が導入されています。アシスタントは、ユーザーが現在のアクティビティのコンテキストに応じたアクションを取得できる最上位のウィンドウです。これらのアクションには、デバイス上の他のアプリへのディープリンクが含まれることもあります。

ユーザーがアシスタントを起動するには、ホームボタンを長押しするか、キーフレーズを言います。それに応じて、コンテキストに応じたアクションを表示する最上位ウィンドウが開きます。

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

このガイドでは、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() が呼び出されて、完全な ACTION_ASSIST インテントがビルドされます。このインテントには、AssistStructure のインスタンスとして表される現在のアプリのすべてのコンテキストが含まれます。このメソッドをオーバーライドして、任意のバンドル内に配置して、アシストインテントの 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() のデフォルト実装を使用して、テキストとビューの階層情報を収集します。ビューにカスタムテキスト描画が実装されている場合は、onProvideStructure() をオーバーライドし、setText(CharSequence) を呼び出して、ユーザーに表示するテキストをアシスタントに提供します。

ほとんどの場合、ユーザー補助サポートを実装することで、アシスタントは必要な情報を取得できます。ユーザー補助サポートを実装するには、アプリのユーザー補助機能を強化するで説明している、次のようなおすすめの方法に従ってください。

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 パーミッションも必要です。アシスタントは、AssistStructure のインスタンスとして表されるテキストとビューの階層を onHandleAssist() で受け取ることができます。onHandleScreenshot() を介してスクリーンショットを受け取ります。

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