Intent bawaan (BII) memungkinkan aplikasi Anda mengekspresikan kemampuan fulfillment-nya ke Google. Dengan menyatakan kemampuan dalam file shortcuts.xml Anda dan memetakan parameter intent ke pemenuhan, Anda memungkinkan Asisten Google untuk 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 contohnya yang dapat digunakan untuk pengujian ada dalam referensi intent bawaan.
Banyak BII memiliki persyaratan deployment tertentu dan rekomendasi. Persyaratan dan rekomendasi ini membantu aplikasi Anda memberikan pengalaman terbaik bagi pengguna Anda.
![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness1.png?authuser=9&hl=id)
START_EXERCISE
dengan suara
kueri ke Asisten.![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness3.png?authuser=9&hl=id)
START_EXERCISE
.![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness4-widget.png?authuser=9&hl=id)
Menerapkan BII dan menangani parameter intent
Untuk Action Aplikasi, Anda mendeklarasikan kemampuan dan menangani parameter BII dalam file shortcuts.xml Anda. Untuk menerapkan BII dan menangani parameter, 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 Android intentextras
menggunakan nama yang Anda pilih. - Jika Anda menggunakan URL deep link, gunakan parameter bernama di kueri string template URL.
- Jika Anda menggunakan
Untuk menangani parameter BII, petakan parameter BII ke
parameter intent Android eksplisit yang sesuai di capability
Anda.
Kemudian, Anda dapat menggunakan nilainya di aplikasi Anda. Aplikasi Anda tidak perlu menangani
Parameter BII. Namun, coba tangani kolom data yang ditandai sebagai "Direkomendasikan"
dalam referensi intent bawaan.
Anda bisa mendefinisikan beberapa fulfillment intent, masing-masing dengan set parameter yang direkomendasikan. Google memilih pemenuhan pesanan yang sesuai berdasarkan parameter kemampuan yang diidentifikasinya dari kueri pengguna dan yang dinyatakan dalam intent.
Misalnya, actions.intent.START_EXERCISE
merekomendasikan agar aplikasi Anda menangani parameter BII exercise.name
, tetapi Anda
dapat menerapkan BII di aplikasi Anda tanpa parameter.
Anda mungkin melakukan ini jika Anda ingin
menangani kueri pengguna tanpa
nama latihan, seperti "Minta Aplikasi Contoh untuk mulai melacak latihan".
Tujuan cuplikan berikut memiliki penggantian ke fulfillment tanpa parameter wajib 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 yang 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 HTTP/HTTPS. Untuk melayani pengguna dengan lebih baik, Asisten mungkin memberikan lintang dan nilai bujur Contoh Restoran terdekat dengan aplikasi tersebut.
Sebagai persyaratan tambahan, Anda tidak ingin aplikasi langsung melakukan tindakan yang mengubah keadaan pengguna di dunia nyata (misalnya, mentransfer uang, melakukan pemesanan, atau mengirim pesan) tanpa terlebih dahulu mengonfirmasi tindakan 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 kasus ini,
gunakan nilai argumen sebagai argumen penelusuran dan bawa pengguna ke halaman penelusuran
laman aplikasi. Mereka dapat membedakan dan memilih item yang tepat.
Misalnya, jika kueri pengguna adalah “Pesan dari Contoh Restoran” untuk
BII ORDER_MENU_ITEM
, Anda dapat menyajikan 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 untuk pengujian developer dan untuk pemicu pengguna dari Asisten.