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

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

Android 6.0 Marshmallow では、アシスタントを通じてアプリを操作できる新しい方法が導入されていますたとえば、 Google アシスタント。アシスタントは、ユーザーがコンテキストから情報を確認するための最上位のウィンドウ現在のアクティビティに関連するアクションを選択できます。これらのアクションには、Google Chat 上の他のアプリへのディープリンクがクリックします。

アシスタントを起動するには、ホームボタンを長押しするか、 keyphrase。すると、最上位ウィンドウが開き、コンテキストに基づいて向上します

Google アシスタントなどのアシスタントアプリは、API を介してアシスタントオーバーレイウィンドウを実装します。これは、Android プラットフォームレベルの機能と連動する Now on Tap です。システムを使用すると、ユーザーがアシスタントアプリを選択できます。アシスタントアプリは、 Android の Assist API。

このガイドでは、Android アプリで Android の Assist API を使用してアシスタントを改善する仕組みについて説明します向上させることができますアシスタントを起動できるようにメディアアプリを作成する方法と操作方法については、Google アシスタントとメディアアプリをご覧ください。

アシスタントの使用

アシスタントの標準的なユーザー操作を図 1 に示します。ユーザーが長押ししたときホームボタンを押すと、Assist API コールバックが ソースアプリにインストールする必要があります（ステップ 1）。アシスタントがオーバーレイウィンドウをレンダリングします（ステップ 2 と 3）。ユーザーが実行するアクションを選択します。選択したアクションをアシスタントが実行したとえば、（destination）レストランアプリへのディープリンクを含むインテントを起動します（ステップ 4）。

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

ユーザーは、[Settings] >アプリ >デフォルトのアプリ > アシストと音声入力。ユーザーはシステムオプション（画面コンテンツをテキストとして表示し、スクリーンショットにアクセスします。

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

ソースアプリ

アプリがユーザーの情報源としてアシスタントと連携できるようにするには、ユーザー補助のベストプラクティスに従うだけでよいプラクティスをご覧ください。このセクションでは、その他の情報を提供する方法について説明します。ユーザーエクスペリエンスの向上に役立ちカスタムビューなど、特別な処理が必要なリソースを表示できます。

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

テキストやスクリーンショットに加え、アプリは情報を取得できます。たとえば、自分の音楽アプリは現在のアルバム情報を渡すことで、アシスタントがその情報を現在のアクティビティに適した、よりスマートなアクションを提案します。なお Assist API はメディアコントロールを提供していません。メディアコントロールを追加するには、以下をご覧ください。 Google アシスタントとメディアアプリ。

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

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

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

コンテキストを提供する

ユーザーがアシスタントを起動すると onProvideAssistData() が呼び出され、完全なイメージが ACTION_ASSIST インテントのコンテキストを AssistStructure のインスタンスとして表される現在のアプリケーション。このメソッドをオーバーライドして、バンドルに自由に選択して EXTRA_ASSIST_CONTEXT の一部です。

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

アプリに onProvideAssistContent() を実装できるコンテンツ関連の参照を提供してアシスタントのユーザーエクスペリエンスを向上させる履歴が表示されます。アプリのコンテンツの説明は、 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(), これには次のような利点があります

<ph type="x-smartling-placeholder"></ph> 提供されたコンテンツを調整しますインテントをアクティビティのトップレベルのコンテキストをより良く反映しています。
<ph type="x-smartling-placeholder"></ph> 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 の場合、ユーザーはアクティブなアシスタントアプリを選択できます。「アシスタントアプリは、に示すように VoiceInteractionSessionService と VoiceInteractionSession の実装を提供する必要があります。（こちらの VoiceInteraction の例をご覧ください）また、BIND_VOICE_INTERACTION パーミッションも必要です。すると、アシスタントは onHandleAssist() の AssistStructure のインスタンスとして表されるテキストとビュー階層を受け取ります。 onHandleScreenshot() を介してスクリーンショットを受け取ります。

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