Sebagai developer, Anda dapat menentukan pintasan untuk menjalankan tindakan tertentu di aplikasi Anda. Pintasan ini dapat ditampilkan di peluncur atau asisten yang didukung, seperti Asisten Google, dan membantu pengguna memulai tugas umum atau yang direkomendasikan dengan cepat dalam aplikasi Anda.
Kumpulan panduan ini menunjukkan kepada Anda cara membuat dan mengelola pintasan aplikasi. Selain itu, Anda akan mempelajari beberapa praktik terbaik yang akan meningkatkan keefektifan pintasan Anda.
Jenis pintasan
Setiap pintasan mereferensikan satu atau beberapa intent, yang masing-masingnya akan meluncurkan tindakan tertentu di aplikasi Anda saat pengguna memilih pintasan. Jenis pintasan yang Anda buat untuk aplikasi Anda bergantung pada kasus penggunaan utama aplikasi tersebut. Contoh tindakan yang dapat Anda ekspresikan sebagai pintasan meliputi tindakan berikut:
- Menulis email baru di aplikasi email.
- Mengarahkan pengguna ke lokasi tertentu dalam aplikasi peta.
- Mengirim pesan ke teman di aplikasi komunikasi.
- Memutar episode acara TV berikutnya di aplikasi media.
- Memuat titik simpan terakhir di aplikasi game.
- Memesan minuman di aplikasi pengiriman menggunakan suara, dengan perintah lisan.
Catatan: Hanya aktivitas utama—aktivitas yang menangani tindakan
Intent.ACTION_MAIN
dan kategori
Intent.CATEGORY_LAUNCHER
—yang dapat memiliki pintasan. Jika aplikasi memiliki beberapa aktivitas
utama, Anda perlu menentukan kumpulan pintasan untuk setiap aktivitas.
Anda dapat memublikasikan jenis pintasan berikut untuk aplikasi Anda:
- Pintasan statis ditentukan dalam file resource yang dikemas ke dalam APK atau app bundle.
- Pintasan dinamis dapat didorong, diperbarui, dan dihapus oleh aplikasi Anda hanya pada runtime.
-
Pintasan yang dipasangi pin dapat ditambahkan ke peluncur yang didukung pada runtime, jika pengguna memberikan izin.
Catatan: Pengguna juga dapat membuat sendiri pintasan yang dipasangi pin dengan menyalin pintasan statis dan dinamis aplikasi Anda ke peluncur.
Menampilkan pintasan di asisten menggunakan kemampuan
Kemampuan di shortcuts.xml memungkinkan Anda mendeklarasikan jenis tindakan
yang dapat dilakukan pengguna untuk meluncurkan aplikasi dan langsung melakukan tugas tertentu. Misalnya, Anda dapat
mengizinkan pengguna untuk mendapatkan kontrol suara aplikasi melalui Asisten Google dengan mendeklarasikan
elemen capability yang memperluas fungsi dalam aplikasi ke Action Aplikasi Asisten. Untuk detail selengkapnya,
lihat Menambahkan kemampuan.
Batasan pintasan
Sebagian besar peluncur yang didukung menampilkan hingga empat pintasan sekaligus, yang mencakup pintasan statis dan dinamis. Saat mendorong pintasan dinamis untuk ditampilkan di platform Google seperti Asisten Google, gunakan library Integrasi Pintasan Google, agar tidak terkena batasan pintasan.
Jika Anda memilih untuk tidak menggunakan library Integrasi Pintasan Google, aplikasi Anda dapat mendorong hingga jumlah maksimum pintasan yang didukung oleh perangkat pada satu waktu. Pintasan yang dipublikasikan dengan cara ini hanya muncul dalam peluncur Android dan tidak dapat ditemukan di platform Google seperti Asisten.
Catatan: Jumlah pintasan maksimum yang didukung oleh perangkat dapat bervariasi. Gunakan metode getMaxShortotongCountPerActivity() untuk menentukan jumlah pintasan yang didukung perangkat tertentu.
Tidak ada batasan jumlah pintasan yang dipasangi pin pada aplikasi Anda yang dapat dibuat oleh pengguna. Meskipun tidak dapat menghapus pintasan yang dipasangi pin, aplikasi Anda tetap dapat menonaktifkan pintasan tersebut.
Catatan: Meskipun aplikasi lain tidak dapat mengakses metadata dalam pintasan Anda, peluncurnya dapat mengakses data tersebut. Oleh karena itu metadata tersebut harus menyembunyikan informasi sensitif pengguna.
Untuk mulai membuat pintasan untuk aplikasi Anda, lihat halaman berikut:
Untuk detail selengkapnya tentang operasi yang dapat dijalankan di pintasan,
lihat referensi API
ShortcutManager.