Intent bawaan (BII) memungkinkan aplikasi Anda mengekspresikan kemampuan fulfillment-nya ke Google. Dengan mendeklarasikan kemampuan dalam file shortcut.xml dan memetakan parameter intent ke fulfillment, Anda memungkinkan Asisten Google meluncurkan aplikasi Anda ke layar tertentu sebagai respons terhadap kueri, sehingga pengguna dapat menyelesaikan tugas.
Intent bawaan dikelompokkan berdasarkan kategori aplikasi. Setiap kategori mewakili kumpulan tugas umum yang sering ingin dilakukan pengguna di aplikasi mereka. Daftar lengkap BII yang tersedia, parameternya, dan contoh kueri yang dapat digunakan untuk pengujian ada di referensi intent bawaan.
Banyak BII memiliki persyaratan dan rekomendasi deployment tertentu. Persyaratan dan rekomendasi ini membantu aplikasi Anda memberikan pengalaman terbaik kepada pengguna.
Menerapkan BII dan menangani parameter intent
Untuk Action Aplikasi, Anda mendeklarasikan kemampuan dan menangani parameter BII di file shortcuts.xml Anda. Untuk menerapkan BII dan menangani parameternya, ikuti langkah-langkah berikut:
- Deklarasikan
capability
dengan BII yang dipilih. - Tambahkan elemen
parameter
bertingkat untuk setiap kolom BII yang ingin Anda tambahkan.- Jika Anda menggunakan
targetClass
atautargetPackage
, petakan semuanya ke intent Androidextras
menggunakan nama yang Anda pilih. - Jika Anda menggunakan URL deep link, gunakan parameter bernama dalam string kueri template URL.
- Jika Anda menggunakan
Untuk menangani parameter BII, petakan parameter BII ke
parameter yang sesuai dari intent Android eksplisit di capability
.
Kemudian, Anda dapat menggunakan nilainya di aplikasi Anda. Aplikasi Anda tidak perlu menangani
parameter BII. Namun, cobalah untuk menangani kolom data yang ditandai sebagai "Direkomendasikan" dalam referensi intent bawaan.
Anda dapat menentukan beberapa fulfillment intent, masing-masing dengan kumpulan parameter yang direkomendasikan sendiri. Google memilih fulfillment yang sesuai berdasarkan parameter kemampuan yang diidentifikasinya dari kueri pengguna dan yang dideklarasikan dalam intent.
Misalnya, intent actions.intent.START_EXERCISE
merekomendasikan agar aplikasi Anda menangani parameter BII exercise.name
, tetapi Anda
dapat menerapkan BII di aplikasi tanpa parameter.
Anda mungkin perlu melakukannya jika ingin menangani kueri pengguna tanpa nama
latihan tertentu, seperti "Minta Aplikasi Contoh untuk mulai melacak latihan".
Cuplikan berikut memiliki penggantian ke fulfillment tanpa parameter yang diperlukan jika parameter tidak disertakan dalam kueri pengguna:
<?xml version="1.0" encoding="utf-8"?>
<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:targetClass="com.example.myapplication.Activity1"
android:targetPackage="com.example.myapplication">
<parameter
android:name="exercise.name"
android:key="exerciseType"
android:required="true"
/>
</intent>
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.example.myapplication.Activity2">
</intent>
</capability>
</shortcuts>
Asisten Google melakukan upaya terbaik untuk memberikan informasi yang paling relevan kepada pengguna saat menampilkan parameter value ke aplikasi Anda. Misalnya, kueri pengguna untuk memesan pizza dari aplikasi seluler Contoh Restoran tidak selalu menyertakan lokasi. Untuk melayani pengguna dengan lebih baik, Asisten mungkin memberikan nilai lintang dan bujur Contoh Restoran terdekat ke aplikasi tersebut.
Sebagai persyaratan tambahan, sebaiknya aplikasi Anda tidak langsung melakukan tindakan yang mengubah status pengguna di dunia nyata (misalnya, mentransfer uang, melakukan pemesanan, atau mengirim pesan) tanpa terlebih dahulu mengonfirmasi tindakan tersebut dengan pengguna.
Disambiguasi
Argumen yang diteruskan ke aplikasi Anda melalui <url-parameter>
atau tambahan intent mungkin tidak
secara unik mengidentifikasi item yang ingin Anda tampilkan kepada pengguna. Dalam hal ini,
gunakan nilai argumen sebagai argumen penelusuran dan arahkan pengguna ke halaman penelusuran
aplikasi. Mereka dapat membedakan dan memilih item yang tepat.
Misalnya, jika kueri pengguna adalah “Pesan dari Contoh Restoran” untuk
ORDER_MENU_ITEM
BII, Anda dapat menampilkan daftar
restoran yang namanya cocok dengan istilah "Example Restaurant"
.
Dukungan bahasa dan lokalitas
Lokalitas yang didukung untuk pengembangan dan pengujian oleh setiap BII Action Aplikasi tercantum dalam referensi intent bawaan. Beberapa BII memiliki dukungan lokalitas yang berbeda untuk pengujian developer dan untuk pemicuan pengguna dari Asisten.