ความสามารถใน shortcuts.xml
ช่วยให้คุณประกาศประเภทการดำเนินการที่ผู้ใช้ทำได้
เพื่อเปิดแอปและดำเนินงานที่เจาะจงได้โดยตรง
ตัวอย่างเช่น การดำเนินการของแอป Google Assistant ใช้ความสามารถต่างๆ เพื่อให้นักพัฒนาซอฟต์แวร์
ขยายฟีเจอร์ในแอปให้ครอบคลุม Intent ในตัว (BII) เพื่อให้ผู้ใช้เปิดใช้งาน
และควบคุมฟีเจอร์เหล่านั้นด้วยคำสั่งเสียง ความสามารถประกอบด้วย
ชื่อของการดำเนินการและ intent
ที่กำหนดเป้าหมายไปยังปลายทางในแอปของคุณที่
แก้ปัญหาความตั้งใจของผู้ใช้
กำหนดความสามารถใน shortcuts.xml
คุณกำหนดองค์ประกอบ capability
ในไฟล์ทรัพยากร shortcuts.xml
ใน
โปรเจ็กต์การพัฒนาแอป Android หากต้องการกำหนดเอลิเมนต์ capability
ให้ทำ
ดังต่อไปนี้:
- สร้างทรัพยากร
shortcuts.xml
โดยทำตามวิธีการในสร้าง แป้นพิมพ์ลัดแบบคงที่ ระบุข้อมูลที่จำเป็นต่อไปนี้ในความสามารถของคุณ
ชื่อความสามารถ: การดำเนินการที่คุณต้องการให้แอปรองรับ โปรดดู เอกสารคอมโพเนนต์สำหรับฟีเจอร์ที่ต้องใช้ความสามารถ คำจำกัดความ คำสั่งที่เปิดใช้การสั่งงานด้วยเสียงของแอปจะใช้ BII
Action ID
สำหรับชื่อความสามารถ ซึ่งดูได้ในการอ้างอิง BII ตัวอย่างเช่นGET_THING
BII แสดงAction ID
เป็นactions.intent.GET_THING
ปลายทางของแอป: ปลายทางในแอปที่การดำเนินการเปิดขึ้น ดำเนินการตามคำขอของผู้ใช้ กำหนดปลายทางของแอปโดยใช้องค์ประกอบ
intent
ฝังอยู่ในcapability
การแมปพารามิเตอร์:
intent
แต่ละรายการอาจมีพารามิเตอร์ที่จะ ส่งเป็นข้อมูลextra
ของ Intent เช่น การดำเนินการของแอปแต่ละรายการ BII รวมฟิลด์ที่แสดงข้อมูลที่ผู้ใช้มักให้ไว้ในข้อความค้นหาที่ ทริกเกอร์ 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
ประกาศการรองรับพารามิเตอร์ BIIexercise.name
และวิธีส่งค่าพารามิเตอร์ (รวบรวม) จากผู้ใช้ - เป็นข้อมูลเพิ่มเติมในintent
เชื่อมโยงทางลัดกับความสามารถ
เมื่อกำหนดความสามารถแล้ว คุณสามารถขยายฟังก์ชันโดยการเชื่อมโยง
ด้วยแป้นพิมพ์ลัดแบบคงที่หรือแบบไดนามิก วิธีลิงก์ทางลัดไปยัง capability
ขึ้นอยู่กับฟีเจอร์ที่กำลังติดตั้งและคำที่ใช้จริงที่มีอยู่ใน
คำขอของผู้ใช้ ตัวอย่างเช่น เมื่อผู้ใช้เริ่มการวิ่งในการติดตามการออกกำลังกายของคุณ
แอปได้โดยถาม Assistant ว่า "Ok Google เริ่มเรียกใช้ใน ExampleApp" ผู้ช่วย
สามารถใช้ทางลัดเพื่อเปิดอินสแตนซ์ของ capability
ที่กำหนด
เอนทิตีการออกกำลังกายของ "วิ่ง" สำหรับพารามิเตอร์ exercise.name
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงทางลัดกับการดำเนินการของแอปได้ที่แอป ภาพรวมการดำเนินการ