สร้างทางลัด

เมื่อออกแบบและสร้างทางลัดของแอป ให้ปฏิบัติตามหลักเกณฑ์ต่อไปนี้

ทำตามหลักเกณฑ์ด้านการออกแบบ
หากต้องการทำให้ทางลัดของแอปมีความสอดคล้องกับทางลัดที่ใช้สำหรับแอประบบ ให้ทำตามหลักเกณฑ์การออกแบบไอคอนทางลัดของแอป
เผยแพร่ทางลัดที่แตกต่างกันเพียง 4 รายการ

แม้ว่า API จะรองรับทางลัดแบบคงที่และแบบไดนามิกรวมกันได้สูงสุด 15 รายการสำหรับแอปของคุณ แต่เราขอแนะนำให้คุณเผยแพร่ทางลัดที่แตกต่างกันเพียง 4 รายการเพื่อปรับปรุงลักษณะที่ปรากฏใน Launcher

นอกจากการแสดงทางลัดใน Launcher แล้ว ให้ใช้ไลบรารีการผสานรวมทางลัดของ Google เพื่อแสดงทางลัดในแพลตฟอร์มต่างๆ ของ Google เช่น Google Assistant ไลบรารีนี้รองรับการพุชทางลัดแบบไดนามิกได้ไม่จำกัดจำนวน หากคุณใช้ไลบรารีนี้เพื่อพุชทางลัดจำนวนมาก เราขอแนะนำให้ตั้งค่า rank ของทางลัดที่ต้องปรากฏใน Launcher ที่รองรับโดยเรียกใช้เมธอด setRank()

จำกัดความยาวคำอธิบายทางลัด

พื้นที่ในเมนูที่แสดงทางลัดของแอปใน Launcher มีจำกัด หากเป็นไปได้ ให้จำกัดความยาวของ "คำอธิบายแบบย่อ" ของทางลัดไว้ที่ 10 อักขระ และจำกัดความยาวของ "คำอธิบายแบบยาว" ไว้ที่ 25 อักขระ

ดูข้อมูลเพิ่มเติมเกี่ยวกับป้ายกำกับสำหรับทางลัดแบบคงที่ได้ที่หัวข้อปรับแต่งค่าแอตทริบิวต์ สำหรับทางลัดแบบไดนามิกและแบบปักหมุด โปรดอ่านเอกสารอ้างอิงเกี่ยวกับ setLongLabel() และ setShortLabel()

เก็บประวัติการใช้ทางลัดและการดำเนินการ

สำหรับทางลัดแต่ละรายการที่คุณสร้าง ให้พิจารณาวิธีต่างๆ ที่ผู้ใช้สามารถทำงานเดียวกันให้เสร็จได้โดยตรงภายในแอปของคุณ เรียกใช้ reportShortcutUsed() ในแต่ละสถานการณ์เหล่านี้เพื่อให้ Launcher เก็บประวัติที่ถูกต้องเกี่ยวกับความถี่ที่ผู้ใช้ดำเนินการซึ่งแสดงถึงทางลัดของคุณ

อัปเดตแป้นพิมพ์ลัดเฉพาะเมื่อยังคงความหมายเดิมไว้

เมื่อเปลี่ยนทางลัดแบบไดนามิกและทางลัดที่ปักหมุดไว้ ให้เรียกใช้ updateShortcuts() เฉพาะเมื่อเปลี่ยนข้อมูลของทางลัดที่ยังคงความหมายเดิมไว้ หรือใช้วิธีใดวิธีหนึ่งต่อไปนี้ โดยขึ้นอยู่กับประเภทของทางลัดที่คุณกำลังสร้างใหม่

  • ทางลัดแบบไดนามิก: pushDynamicShortcut()
  • ทางลัดที่ปักหมุดไว้: requestPinShortcut()

    ตัวอย่างเช่น หากคุณสร้างทางลัดสำหรับการนำทางไปยังซูเปอร์มาร์เก็ต คุณควรอัปเดตทางลัดหากชื่อของซูเปอร์มาร์เก็ตเปลี่ยนไปแต่สถานที่ตั้งยังคงเหมือนเดิม แต่หากผู้ใช้เริ่มซื้อสินค้าที่ซูเปอร์มาร์เก็ตสาขาอื่น คุณควรสร้างทางลัดใหม่

ตรวจสอบทางลัดแบบไดนามิกทุกครั้งที่เปิดแอป
ระบบจะไม่เก็บทางลัดแบบไดนามิกไว้เมื่อผู้ใช้กู้คืนข้อมูลไปยังอุปกรณ์ใหม่ ด้วยเหตุนี้ เราขอแนะนำให้คุณตรวจสอบจำนวนออบเจ็กต์ที่ getDynamicShortcuts() แสดงผลทุกครั้งที่เปิดแอปและเผยแพร่ทางลัดแบบไดนามิกอีกครั้งตามต้องการ ดังที่แสดงในข้อมูลโค้ดในการสำรองและกู้คืนข้อมูล