เพิ่มความสามารถลงในทางลัด

ความสามารถใน shortcuts.xml ช่วยให้คุณประกาศประเภทการดำเนินการที่ผู้ใช้ทำได้ เพื่อเปิดแอปและดำเนินงานที่เจาะจงได้โดยตรง

ตัวอย่างเช่น การดำเนินการของแอป Google Assistant ใช้ความสามารถต่างๆ เพื่อให้นักพัฒนาซอฟต์แวร์ ขยายฟีเจอร์ในแอปให้ครอบคลุม Intent ในตัว (BII) เพื่อให้ผู้ใช้เปิดใช้งาน และควบคุมฟีเจอร์เหล่านั้นด้วยคำสั่งเสียง ความสามารถประกอบด้วย ชื่อของการดำเนินการและ intent ที่กำหนดเป้าหมายไปยังปลายทางในแอปของคุณที่ แก้ปัญหาความตั้งใจของผู้ใช้

กำหนดความสามารถใน shortcuts.xml

คุณกำหนดองค์ประกอบ capability ในไฟล์ทรัพยากร shortcuts.xml ใน โปรเจ็กต์การพัฒนาแอป Android หากต้องการกำหนดเอลิเมนต์ capability ให้ทำ ดังต่อไปนี้:

1. สร้างทรัพยากร shortcuts.xml โดยทำตามวิธีการในสร้าง แป้นพิมพ์ลัดแบบคงที่

2. ระบุข้อมูลที่จำเป็นต่อไปนี้ในความสามารถของคุณ

   • ชื่อความสามารถ: การดำเนินการที่คุณต้องการให้แอปรองรับ โปรดดู เอกสารคอมโพเนนต์สำหรับฟีเจอร์ที่ต้องใช้ความสามารถ คำจำกัดความ คำสั่งที่เปิดใช้การสั่งงานด้วยเสียงของแอปจะใช้ 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 ประกาศการรองรับพารามิเตอร์ BII exercise.name และวิธีส่งค่าพารามิเตอร์ (รวบรวม) จากผู้ใช้ - เป็นข้อมูลเพิ่มเติมใน intent

เชื่อมโยงทางลัดกับความสามารถ

เมื่อกำหนดความสามารถแล้ว คุณสามารถขยายฟังก์ชันโดยการเชื่อมโยง ด้วยแป้นพิมพ์ลัดแบบคงที่หรือแบบไดนามิก วิธีลิงก์ทางลัดไปยัง capability ขึ้นอยู่กับฟีเจอร์ที่กำลังติดตั้งและคำที่ใช้จริงที่มีอยู่ใน คำขอของผู้ใช้ ตัวอย่างเช่น เมื่อผู้ใช้เริ่มการวิ่งในการติดตามการออกกำลังกายของคุณ แอปได้โดยถาม Assistant ว่า "Ok Google เริ่มเรียกใช้ใน ExampleApp" ผู้ช่วย สามารถใช้ทางลัดเพื่อเปิดอินสแตนซ์ของ capability ที่กำหนด เอนทิตีการออกกำลังกายของ "วิ่ง" สำหรับพารามิเตอร์ exercise.name

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเชื่อมโยงทางลัดกับการดำเนินการของแอปได้ที่แอป ภาพรวมการดำเนินการ