應用程式動作的內建意圖

內建意圖 (BII) 可讓應用程式表達其執行要求功能。 Google。在 shortcuts.xml 檔案中宣告功能,並 只要將意圖參數對應至執行要求,就能 讓 Google 助理在特定畫面上啟動您的應用程式以回應 以便使用者完成工作

系統會根據應用程式類別將內建意圖分組。每個類別 代表使用者經常執行的工作之一 應用程式。可用 BII 的完整清單、參數與範例 如需可供測試的查詢,請參閱內建意圖參考資料

許多 BII 都有特定的部署需求和 最佳化建議。這些規定和建議有助應用程式達成目標 就能為使用者提供最佳體驗。

圖 1. 透過語音叫用 START_EXERCISE BII 向 Google 助理下達的指令
圖 2. 在特定畫面上啟動應用程式 開始進行 START_EXERCISE 工作。
圖 3 顯示小工具以回應查詢。

實作 BII 及處理意圖參數

對於應用程式動作,您需要宣告功能及處理 BII 參數 shortcuts.xml 檔案。如要實作 BII,並處理 參數,請按照下列步驟操作:

  1. 使用所選的 BII 宣告 capability
  2. 為您要新增的每個 BII 欄位加入巢狀 parameter 元素。
    1. 如果您使用 targetClasstargetPackage,請將其對應至 Android extras
    2. 如果您使用深層連結網址,請在查詢中使用具名參數 字串字串。

如要處理 BII 參數,請將 BII 參數對應至 capability 中明確 Android 意圖的對應參數。 接著,您就可以在應用程式中使用這個值。應用程式無須處理 BII 參數。然而,請務必嘗試處理標記為「推薦」的資料欄位 內建意圖參考資料中所列。

您可以定義多個意圖執行要求,每個意圖都有各自的一組 建議使用的參數Google 會根據 功能參數會從使用者查詢加以識別,以及宣告的 或擷取在意圖中寫入的資料

例如:actions.intent.START_EXERCISE 意圖建議應用程式處理 exercise.name BII 參數,但 但不需參數,就能在應用程式中實作 BII。 如想在不使用特定鍵的情況下處理使用者查詢 運動的名稱,例如「要求範例應用程式開始追蹤運動」

下列程式碼片段具有不含必要參數的執行要求做為備用執行方式 表示使用者的查詢不包含參數:

<?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 助理會盡力為 將參數值傳回給應用程式的使用者。例如,使用者查詢 透過範例餐廳的行動應用程式訂購披薩時,不一定會包含 或 HTTP/HTTPS 位置為了提供使用者更優質的服務,Google 助理可能會提供緯度 距離該應用程式最近的範例餐廳 (Example Restaurant) 和經度值。

額外規定,您不希望應用程式直接 會修改使用者實際狀態的動作 (例如: 付款、下單或傳送訊息) 時, 執行動作

消歧

透過 <url-parameter> 或意圖額外項目傳遞至應用程式的引數可能無法 明確識別您要向使用者顯示的項目。在本例中 使用引數值做為搜尋引數,並將使用者導向搜尋 頁面。以便區分和選擇正確的商品。

舉例來說,如果使用者查詢是「前往範例餐廳訂購」 BII ORDER_MENU_ITEM,您可以向使用者顯示 與「"Example Restaurant"」字詞相符的餐廳。

語言和語言代碼支援

每個應用程式動作 BII 支援的開發和測試語言代碼 內建意圖參考資料列出。某些 BII 有差異 支援開發人員測試和透過 Google 助理觸發的使用者語言。