Intent bawaan untuk Action Aplikasi

Intent bawaan (BII) memungkinkan aplikasi Anda mengekspresikan kemampuan fulfillment-nya ke Google. Dengan mendeklarasikan kemampuan dalam file shortcuts.xml dan memetakan parameter intent ke fulfillment, Anda memungkinkan Asisten Google meluncurkan aplikasi 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.

Gambar 1. Panggil BII START_EXERCISE dengan kueri suara ke Asisten.
Gambar 2. Luncurkan 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. Untuk menerapkan BII dan menangani parameternya, 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 keduanya ke intent Android extras menggunakan nama yang Anda pilih.
    2. Jika Anda menggunakan URL deep link, gunakan parameter bernama dalam string kueri template URL.

Untuk menangani parameter BII, petakan parameter BII ke parameter yang sesuai dari intent Android eksplisit di capability. Kemudian, Anda dapat menggunakan nilainya di aplikasi. Aplikasi Anda tidak diperlukan untuk 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. 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 Anda tanpa parameter. Anda dapat melakukannya jika ingin menangani kueri pengguna tanpa nama latihan tertentu, seperti "Minta Contoh Aplikasi untuk memulai latihan pelacakan".

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 Example Restaurant 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, Anda tidak ingin aplikasi secara langsung melakukan tindakan yang mengubah status pengguna di dunia nyata (misalnya, mentransfer uang, melakukan pemesanan, atau mengirim pesan) tanpa terlebih dahulu mengonfirmasi tindakan tersebut kepada pengguna.

Disambiguasi

Argumen yang diteruskan ke aplikasi Anda melalui <url-parameter> atau tambahan intent mungkin tidak secara unik mengidentifikasi item yang ingin ditampilkan 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" kepada pengguna.

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.