สร้างทางลัด

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

ปฏิบัติตามหลักเกณฑ์การออกแบบ

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

เผยแพร่เฉพาะทางลัดที่แตกต่างกัน 4 รายการ

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

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

จำกัดความยาวของคำอธิบายแป้นพิมพ์ลัด

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

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

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

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

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

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

• ทางลัดแบบไดนามิก: pushDynamicShortcut()

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

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

ตรวจสอบทางลัดแบบไดนามิกทุกครั้งที่เปิดแอป

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