เพิ่มความสามารถลงในทางลัด
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ความสามารถใน shortcuts.xml ช่วยให้คุณประกาศประเภทของการดำเนินการที่ผู้ใช้สามารถทำเพื่อเปิดแอปและทำงานที่เฉพาะเจาะจงได้โดยตรง
ตัวอย่างเช่น App Actions ของ Google Assistant ใช้ความสามารถเพื่อช่วยให้นักพัฒนาแอป
ขยายฟีเจอร์ในแอปไปยังIntent ในตัว (BII) ซึ่งช่วยให้ผู้ใช้เปิดใช้งาน
และควบคุมฟีเจอร์เหล่านั้นได้โดยใช้คำสั่งเสียง ความสามารถประกอบด้วย
ชื่อของการกระทำและintentที่กำหนดเป้าหมายไปยังปลายทางในแอปซึ่ง
แก้ปัญหาความตั้งใจของผู้ใช้
กำหนดความสามารถใน shortcuts.xml
คุณกำหนดองค์ประกอบ capability ในไฟล์ทรัพยากร shortcuts.xml ในโปรเจ็กต์การพัฒนาแอป Android
หากต้องการกำหนดองค์ประกอบ capability ให้ทำดังนี้
- สร้าง
shortcuts.xmlทรัพยากรโดยทำตามวิธีการในสร้าง
ทางลัดแบบคงที่
ระบุข้อมูลที่จำเป็นต่อไปนี้ในความสามารถของคุณ
ชื่อความสามารถ: การกระทำที่คุณต้องการให้แอปของคุณรองรับ โปรดดูเอกสารประกอบของคอมโพเนนต์สำหรับฟีเจอร์ที่ต้องมีคำจำกัดความของความสามารถ คำสั่งที่เปิดใช้เสียงของ App Actions ใช้ BII Action ID
สำหรับชื่อความสามารถ ซึ่งคุณดูได้ในข้อมูลอ้างอิง BII เช่น
GET_THING BII แสดง Action ID เป็น actions.intent.GET_THING
ปลายทางของแอป: ปลายทางในแอปที่การดำเนินการเปิดขึ้นเพื่อ
ตอบสนองคำขอของผู้ใช้ กำหนดปลายทางของแอปโดยใช้องค์ประกอบ intent
ที่ซ้อนอยู่ภายใน capability
การแมปพารามิเตอร์: intent แต่ละรายการอาจมีพารามิเตอร์ที่จะ
ส่งเป็นข้อมูล extra ของ Intent ตัวอย่างเช่น BII ของ App Actions แต่ละรายการ
จะมีช่องที่แสดงข้อมูลซึ่งผู้ใช้มักระบุในคำค้นหาที่
ทริกเกอร์ BII
ตัวอย่างต่อไปนี้แสดงคำจำกัดความความสามารถใน shortcuts.xml
สำหรับ actions.intent.START_EXERCISE ซึ่งเป็น BII ที่ช่วยให้ผู้ใช้ใช้คำสั่งที่พูด
กับ Assistant เพื่อเริ่มการออกกำลังกายในแอปฟิตเนสได้
<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 หากผู้ใช้เรียกใช้ BII นี้โดยถาม Assistant ว่า "Ok
Google เริ่มวิ่งใน ExampleApp หน่อย" Assistant จะทำตามคำขอของผู้ใช้โดยใช้ข้อมูลที่ระบุในองค์ประกอบ intent ที่ซ้อนกัน intent ในตัวอย่างนี้
กำหนดรายละเอียดต่อไปนี้
android:targetPackage ตั้งค่าแพ็กเกจแอปพลิเคชันเป้าหมายสำหรับ
Intent นี้- ฟิลด์
android:targetClass ระบุกิจกรรมปลายทาง ดังนี้
com.example.sampleApp.ExerciseActivity
- Intent
parameter ประกาศการรองรับพารามิเตอร์ BII
exercise.name และวิธีส่งค่าพารามิเตอร์ที่รวบรวม
จากผู้ใช้เป็นข้อมูลเพิ่มเติมใน intent
เชื่อมโยงทางลัดกับความสามารถ
เมื่อกำหนดความสามารถแล้ว คุณจะขยายฟังก์ชันการทำงานได้โดยการเชื่อมโยง
ทางลัดแบบคงที่หรือแบบไดนามิกกับความสามารถนั้น วิธีลิงก์ทางลัดกับ capability
จะขึ้นอยู่กับฟีเจอร์ที่ใช้งานและคำจริงที่รวมอยู่ในคำขอของผู้ใช้
ตัวอย่างเช่น เมื่อผู้ใช้เริ่มวิ่งในแอปติดตามฟิตเนส
โดยถาม Assistant ว่า "Ok Google เริ่มวิ่งใน ExampleApp" Assistant
สามารถใช้ทางลัดเพื่อเปิดอินสแตนซ์ของ capability ที่กำหนดเอนทิตีการออกกำลังกายที่ถูกต้องของ "วิ่ง" สำหรับพารามิเตอร์ exercise.name
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงทางลัดกับการดำเนินการของแอปได้ที่ภาพรวมการดำเนินการของแอป
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-08-27 UTC"],[],[],null,["# Add capabilities to shortcuts\n\nCapabilities in `shortcuts.xml` let you declare the types of actions users can\ntake to launch your app and directly perform a specific task.\n\nFor example, Google Assistant App Actions use capabilities to let developers\nextend in-app features to [built-in intents](//developers.google.com/assistant/app/intents) (BIIs), letting users activate\nand control those features using spoken commands. A capability consists of the\nname of the action and an `intent` targeting the destination in your app that\nresolves the user intent.\n\nDefine capabilities in shortcuts.xml\n------------------------------------\n\nYou define `capability` elements in a `shortcuts.xml` resource file in your\nAndroid app development project. To define a `capability` element, do the\nfollowing:\n\n1. Create a `shortcuts.xml` resource by following the instructions in [Create\n static shortcuts](//develop/ui/views/launch/shortcuts/creating-shortcuts#static).\n2. Include the following required information in your capability:\n\n - **Capability name:** the action you want your app to support. Refer to\n the component documentation for the feature that requires capability\n definitions. App Actions voice-enabled commands use the BII `Action ID`\n for capability names, which you can find in [BII reference](//developers.google.com/assistant/app/reference/built-in-intents). For example,\n the [`GET_THING`](//developers.google.com/assistant/app/reference/built-in-intents/common/get-thing) BII lists its `Action ID` as `actions.intent.GET_THING`.\n\n - **App destination:** the destination in your app the action launches to\n fulfill the user request. Define app destinations using `intent` elements\n nested within the `capability`.\n\n - **Parameter mappings:** each `intent` might contain parameters to be\n passed as `extra` data of the intent. For example, each App Actions BII\n includes fields representing information users often provide in queries that\n trigger the BII.\n\nThe following example demonstrates a capability definition in `shortcuts.xml`\nfor [`actions.intent.START_EXERCISE`](//developers.google.com/assistant/app/reference/built-in-intents/health-and-fitness/start-exercise), a BII that lets users use spoken\ncommands with Assistant to begin a workout in a fitness app: \n\n \u003cshortcuts xmlns:android=\"http://schemas.android.com/apk/res/android\"\u003e\n \u003ccapability android:name=\"actions.intent.START_EXERCISE\"\u003e\n \u003cintent\n android:action=\"android.intent.action.VIEW\"\n android:targetPackage=\"com.example.sampleApp\"\n android:targetClass=\"com.example.sampleApp.ExerciseActivity\"\u003e\n \u003cparameter\n android:name=\"exercise.name\"\n android:key=\"exerciseType\"/\u003e\n \u003c/intent\u003e\n \u003c/capability\u003e\n \u003c/shortcuts\u003e\n\nIn the preceding example, the `\u003ccapability\u003e` `android:name` attribute refers to\nthe `START_EXERCISE` BII. If a user invokes this BII by asking Assistant, *\"Hey\nGoogle, start a run in ExampleApp,\"* Assistant fulfills the user request using\ninformation provided in the nested `intent` element. The `intent` in this sample\ndefines the following details:\n\n- The `android:targetPackage` sets the target application package for this intent.\n- The `android:targetClass` field specifies the destination activity: `com.example.sampleApp.ExerciseActivity`.\n- The intent `parameter` declares support for a BII parameter [`exercise.name`](//developers.google.com/assistant/app/reference/built-in-intents/health-and-fitness/start-exercise#recommended-fields) and how to pass the parameter value---collected from the user---as extra data in the `intent`.\n\nAssociate shortcuts with a capability\n-------------------------------------\n\nOnce you define a capability, you can extend its functionality by associating\nstatic or dynamic shortcuts with it. How shortcuts are linked to a `capability`\ndepends on the feature being implemented and the actual words included in a\nuser's request. For example, when a user begins a run in your fitness tracking\napp by asking Assistant, *\"Hey Google, start a run in ExampleApp.\"* Assistant\ncan use a shortcut to launch an instance of a `capability` that defines a valid\nexercise entity of \"run\" for the `exercise.name` parameter.\n\nFor more information about associating shortcuts to App Actions, see [App\nActions overview](//developers.google.com/assistant/app)."]]
