Intent bawaan untuk Action Aplikasi

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.

Gambar 1. Memanggil BII START_EXERCISE dengan suara kueri ke Asisten.

Gambar 2. Meluncurkan aplikasi ke layar tertentu untuk memulai tugas START_EXERCISE.

Gambar 3. Tampilkan widget sebagai respons terhadap kueri.

​

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:

1. Deklarasikan capability dengan BII yang dipilih.
2. Tambahkan elemen parameter bertingkat untuk setiap kolom BII yang ingin Anda tambahkan.
   1. Jika Anda menggunakan targetClass atau targetPackage, petakan semuanya ke Android intent extras menggunakan nama yang Anda pilih.
   2. Jika Anda menggunakan URL deep link, gunakan parameter bernama di kueri string template URL.

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.

Catatan: Action Aplikasi, seperti semua Action yang mendukung intent bawaan, akan dipicu pada sejumlah faktor, termasuk kualitas dan relevansinya dengan permintaan pengguna. Berdasarkan faktor-faktor tersebut, Google dapat menerapkan kebijaksanaan dalam memunculkan Action Anda sebagai respons atas permintaan 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.