您可以透過 shortcuts.xml
中的功能,宣告使用者啟動應用程式並直接執行特定工作時可採取的動作類型。
舉例來說,Google 助理應用程式動作會利用相關功能,將應用程式內功能擴展至內建意圖 (BII),讓使用者透過語音指令啟動及控制這些功能。功能包含動作名稱,以及指定應用程式中可解析使用者意圖的 intent
。
在 shortcuts.xml 中定義功能
請在 Android 應用程式開發專案的 shortcuts.xml
資源檔案中定義 capability
元素。如要定義 capability
元素,請執行下列操作:
- 按照「建立靜態捷徑」中的操作說明建立
shortcuts.xml
資源。 請在功能中加入下列必要資訊:
功能名稱:您希望應用程式執行的動作。如要瞭解需要功能定義的功能,請參閱元件說明文件。應用程式動作的語音指令使用 BII
Action ID
做為功能名稱,詳情請參閱 BII 參考資料。舉例來說,GET_THING
BII 會將Action ID
列為actions.intent.GET_THING
。應用程式目的地:動作為了滿足使用者要求而啟動的應用程式目的地。請使用以巢狀結構包含在
capability
內的intent
元素來定義應用程式目的地。參數對應:每個
intent
都可能包含要以extra
資料形式傳遞的參數。例如,每個應用程式動作 BII 都包含欄位,代表使用者在觸發 BII 的查詢中經常提供的資訊。
下列範例會展示 shortcuts.xml
中 actions.intent.START_EXERCISE
的功能定義。這個 BII 可讓使用者透過 Google 助理使用語音指令,開始在健身應用程式中健身:
<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:targetPackage="com.example.sampleApp"
android:targetClass="com.example.sampleApp.ExerciseActivity">
<parameter
android:name="exercise.name"
android:key="exerciseType"/>
</intent>
</capability>
</shortcuts>
在上述範例中,<capability>
android:name
屬性會參照 START_EXERCISE
BII。如果使用者問 Google 助理「Ok Google,在 ExampleApp 中開始跑步」,從而叫用這個 BII,Google 助理就會使用巢狀 intent
元素中提供的資訊來執行使用者的要求。此範例中的 intent
定義了下列詳細資料:
android:targetPackage
會設定此意圖的目標應用程式套件。android:targetClass
欄位會指定目的地活動:com.example.sampleApp.ExerciseActivity
。- 意圖
parameter
會宣告支援 BII 參數exercise.name
,以及如何將向使用者收集的參數值做為intent
中的額外資料傳遞。
建立捷徑與功能的關聯
定義功能後,您可以將功能與靜態或動態捷徑建立關聯,藉此擴充其功能。捷徑連結至 capability
的方式取決於實作的功能,以及使用者要求中包含的實際字詞。舉例來說,當使用者要求 Google 助理在健身追蹤應用程式中開始跑步時,便說出「Ok Google,在範例應用程式中開始跑步」。Google 助理可以使用捷徑啟動 capability
的執行個體,為 exercise.name
參數定義有效的運動實體「跑步」。
如要進一步瞭解如何建立捷徑與應用程式動作的關聯,請參閱「應用程式動作總覽」。