本頁面由 Cloud Translation API 翻譯而成。

針對 Google 助理進行上下文最佳化調整

Android 6.0 Marshmallow 推出了透過 Google 助理與應用程式互動的新方式例如 Google Google 助理。助理是一個頂層視窗，使用者可以查看這個視窗以根據與目前活動相關的操作這些動作可能包含透過深層連結前往其他應用程式的深層連結裝置。

使用者長按主畫面按鈕或說出 keyphrase。為回應，系統會開啟頂層視窗，其中顯示相關動作

Google 助理等小幫手應用程式，會透過功能，適用於 Android 平台層級的功能。系統可讓使用者選取助理應用程式，以從您的應用程式取得關聯資訊 Android 的 Assist API。

本指南說明 Android 應用程式如何使用 Android 的 Assist API 提升助理體驗使用者體驗瞭解如何建立媒體應用程式，讓 Google 助理啟動 Google 助理如要控制及控制媒體，請參閱 Google 助理和媒體應用程式。

使用 Google 助理

圖 1 說明一般的 Google 助理使用者互動。當使用者長按則系統會叫用 Assist API 回呼在來源應用程式中 (步驟 1)。Google 助理會顯示重疊視窗 (步驟 2 和 3)。然後選取要執行的動作。Google 助理會執行所選動作例如透過深層連結觸發意圖 (目的地) 餐廳應用程式 (步驟 4)。

圖 1. Google 助理與「觸控即時資訊」功能的互動範例 Google 應用程式

使用者可以選取「設定」> 以設定助理應用程式 >預設應用程式 > 協助與語音輸入。使用者可以變更系統選項，例如存取將畫面內容顯示為文字並存取螢幕截圖，如圖 2 所示。

圖 2. 協助與語音輸入設定

來源應用程式

為了確保您的應用程式能與 Google 助理搭配使用，做為使用者的資訊來源，只需遵循最佳無障礙設計做法。本節說明如何提供其他資訊提升助理使用體驗和情境需要特殊處理的物件，例如自訂 View

分享其他資訊連結 Google 助理

除了文字和螢幕截圖外，應用程式還可以分享提供其他資訊例如你的音樂應用程式可以選擇傳送目前的相簿資訊，讓 Google 助理可以建議根據目前活動制定更明智的決策。請注意，Assist API 不提供媒體控制項。如要新增媒體控制項，請參閱 Google 助理和媒體應用程式。

如要為助理提供額外資訊，應用程式會提供 全域應用程式結構定義，方法是註冊應用程式事件監聽器，可透過活動回呼提供活動專屬資訊，如圖 3：

圖 3. Assist API 生命週期序列圖

為提供全域的應用程式情境，應用程式會建立並註冊 Application.OnProvideAssistDataListener 使用 registerOnProvideAssistDataListener()。為了提供與活動相關的情境資訊，活動覆寫 onProvideAssistData() 和 onProvideAssistContent()。這兩個活動方法會在選用的全域類型「之後」呼叫回呼方法。由於回呼是在主執行緒上執行，因此完成提示。系統只會在活動執行時叫用回呼。

提供相關背景

使用者啟用 Google 助理時，呼叫 onProvideAssistData() 以建構完整的 ACTION_ASSIST 意圖，搭配目前的應用程式，以 AssistStructure 的例項表示。您可以覆寫這個方法任何檔案都可以顯示在輔助意圖的 EXTRA_ASSIST_CONTEXT 部分。

說明內容

應用程式可以實作 onProvideAssistContent() 提供與內容相關的參考資料，改善 Google 助理的使用者體驗與目前活動有關你可以使用以下語言描述應用程式內容： 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() 以便提供用來向 Google 助理呼叫 setText(CharSequence)，向使用者顯示的文字。

在大多數情況下，導入無障礙設計支援後取得所需資訊如要實作無障礙支援請參考建構應用程式可存取，包括：

請提供 android:contentDescription 屬性。
針對自訂檢視畫面填入 AccessibilityNodeInfo。
廠牌確認自訂 ViewGroup 物件正確無誤公開他們的孩子。

排除助理的觀看次數

為處理機密資訊，應用程式可以將目前的檢視畫面從 Google 助理中排除設定 WindowManager 的 FLAG_SECURE 版面配置參數。您必須針對以下項目明確設定 FLAG_SECURE：由活動建立的每個視窗，包括對話方塊。您的應用程式也能使用 setSecure()：排除開啟 Google 助理的介面由於沒有通用 (應用程式層級) 機制來排除助理的所有資料檢視。注意事項該 FLAG_SECURE 不會導致 Assist API 回呼停止以及提示使用 FLAG_SECURE 的活動仍可明確透過前述的回呼向 Google 助理應用程式提供資訊本指南。

注意： 如果是公司帳戶 (Android for Work)，管理員可以停用使用 DevicePolicyManager API 的 setScreenCaptureDisabled() 方法收集工作資料夾的助理資料。

語音互動

也會在發生以下情況時叫用 Assist API 回呼：鍵盤語句偵測。詳情請參閱語音動作說明文件。

Z 順序注意事項

Google 助理會使用顯示在網頁上方的精簡重疊視窗目前的活動使用者可以隨時啟動助理不要建立永久性系統快訊視窗，以及乾擾重疊視窗運作，如圖 4.

圖 4. 輔助圖層 Z 順序

如果應用程式使用系統快訊視窗，請務必移除這些視窗，因為這些視窗留在螢幕會降低使用者體驗

目標應用程式

Google 助理應用程式通常會使用深層連結尋找目的地應用程式。若要如果應用程式可能是目的地應用程式，建議您新增深層連結支援。比對目前使用者情境和深層連結之間，或小工具中顯示的其他潛在動作重疊視窗 (如圖 1 中的步驟 3 所示) 是 Google 助理的實作專用視窗。適用對象舉例來說，Google 助理應用程式會使用深層連結和應用程式連結：將流量導向目的地應用程式

導入自己的 Google 助理

建議您導入專屬助理。如圖所示 2，使用者可以選取啟用的助理應用程式。助理應用程式必須實作 VoiceInteractionSessionService 和 VoiceInteractionSession，如所示這個 VoiceInteraction 範例。此外，您也必須具備 BIND_VOICE_INTERACTION 權限。小幫手就能接收表示為 onHandleAssist() 中 AssistStructure 執行個體的文字和檢視區塊階層。應用程式會透過 onHandleScreenshot() 接收螢幕截圖。