Membuat Action Aplikasi

Action Aplikasi memungkinkan pengguna meluncurkan fungsionalitas di aplikasi Android Anda dengan meminta Asisten Google atau dengan menggunakan pintasan Android yang disarankan oleh Asisten. Ini adalah langkah-langkah utama untuk memperluas aplikasi Android Anda dengan Action Aplikasi:

  1. Identifikasi fungsi dalam aplikasi yang akan dipicu dan intent bawaan (BII) yang cocok.
  2. Memberikan detail fulfillment untuk BII.
  3. Kirim pintasan untuk Action Aplikasi ke Asisten.
  4. Lihat pratinjau Action Aplikasi Anda di perangkat pengujian.
  5. Buat rilis pengujian aplikasi Anda.
  6. Meminta peninjauan dan deployment Action Aplikasi.

Atau, Anda dapat menentukan pintasan dinamis untuk diberikan kepada Asisten sehingga dapat menyarankannya kepada pengguna Anda. Membuat Action Aplikasi menggunakan aplikasi contoh dengan dengan mengikuti codelab Action Aplikasi.

Persyaratan

Sebelum mulai mengembangkan Action Aplikasi, pastikan Anda dan aplikasi Anda memenuhi persyaratan berikut:

  • Anda harus memiliki Akun Google dengan akses ke Konsol Google Play.
  • Aplikasi Anda harus dipublikasikan ke Google Play Store, karena Action Aplikasi hanya tersedia untuk aplikasi yang dipublikasikan di sana. Selain itu, pastikan aplikasi Anda tidak dimaksudkan untuk digunakan di profil kerja, karena Action Aplikasi tidak didukung oleh Google Play Terkelola.
  • Anda memerlukan perangkat fisik atau virtual untuk menguji Action Aplikasi.
  • Anda memerlukan Android Studio versi terbaru.
  • Anda harus menggunakan Akun Google yang sama untuk login ke Android Studio, aplikasi Google di perangkat pengujian, dan Konsol Google Play.
  • Anda harus menyiapkan Asisten di perangkat pengujian dan mengujinya dengan melakukan sentuh lama pada tombol Layar Utama.

Mencocokkan intent bawaan dengan fungsi aplikasi

Mengidentifikasi fungsi di aplikasi Android yang mungkin diinginkan pengguna untuk mengajukan permintaan lisan dan meninjau referensi intent bawaan untuk menemukan BII yang sesuai untuk kasus penggunaan Anda. BII membuat model kueri pengguna untuk tugas yang ingin Jadi, cari BII yang sesuai dengan fungsi utama dan dalam aplikasi Anda.

Ada BII umum yang dapat digunakan oleh hampir semua aplikasi Android, seperti memperluas penelusuran dalam aplikasi ke Asisten dengan fitur actions.intent.GET_THING BII atau mengizinkan pengguna meluncurkan fitur aplikasi tertentu dengan suara mereka dengan menerapkan BII actions.intent.OPEN_APP_FEATURE.

Ada juga BII yang memungkinkan kasus penggunaan vertikal, atau spesifik per kategori. Sebagai contoh, aplikasi latihan mungkin menggunakan actions.intent.START_EXERCISE BII.

Untuk memastikan pengalaman pengguna yang baik, dan menghindari kemungkinan penundaan persetujuan, pastikan setiap BII yang Anda terapkan relevan dengan fungsi dalam aplikasi Anda.

Action Aplikasi berfungsi dengan memulai intent Android dari aplikasi Asisten untuk mengarahkan pengguna langsung ke konten tertentu di aplikasi Anda. Anda dapat menentukan intent untuk meluncurkan aktivitas secara eksplisit dengan menentukan kolom targetClass dan targetPackage. Jika aplikasi sudah menerapkan URL deep link Android, Anda memiliki opsi untuk mengonfigurasi intent agar menggunakan deep link untuk fulfillment. Untuk detail selengkapnya, lihat artikel Menguji aktivitas secara mendalam link.

Memberikan detail fulfillment untuk intent bawaan

Sebagian besar pembuatan Action Aplikasi adalah menyatakan kemampuan di File resource shortcuts.xml aplikasi Android tempat Anda menentukan BII yang dipilih dan fulfillment yang sesuai. BII membuat model kueri pengguna untuk sebuah tugas, dan intent fulfillment menyediakan informasi kepada Asisten tentang cara melakukan tugas tersebut.

Dalam file shortcuts.xml, BII direpresentasikan sebagai <capability> , dan setiap fulfillment direpresentasikan sebagai elemen <intent>:

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

Untuk sebagian besar BII, Anda mengekstrak parameter intent dari kueri pengguna berdasarkan entity schema.org. Aplikasi Anda kemudian menggunakan BII tersebut parameter untuk mengarahkan pengguna ke kemampuan yang dipilih. Misalnya, sebelumnya kode memetakan parameter BII exercise.name ke exercise_name Android Parameter intent.

Jika memenuhi tindakan menggunakan deep link, Anda dapat menggunakan kolom urlTemplate untuk menentukan deep URL yang dihasilkan Asisten URL:

<shortcuts>
    <capability android:name="actions.intent.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                android:mimeType="text/*">
            </parameter>
        </intent>
    </capability>
</shortcuts>

Untuk detail penting tentang cara menambahkan Action Aplikasi ke file shortcuts.xml, lihat Membuat shortcuts.xml. Halaman tersebut juga menjelaskan cara menetapkan parameter value yang diharapkan oleh aplikasi Anda.

Mengimplementasikan intent bawaan GET_THING

Jika aplikasi Anda memiliki fungsi penelusuran, Anda harus menerapkan BII actions.intent.GET_THING untuk fungsi tersebut. Asisten dapat meneruskan pengguna ke fungsi penelusuran aplikasi Anda untuk hasil dalam aplikasi saat mereka membuat kueri seperti "Ok Google, telusuri Contoh Hal di Aplikasi Contoh".

Di file shortcuts.xml Anda, implementasikan <capability> untuk BII actions.intent.GET_THING saat Anda menerapkan BII lainnya. Anda dapat menggunakan beberapa fulfillment untuk GET_THING selama Anda menyediakan setidaknya satu fulfillment yang meneruskan pengguna ke fungsi penelusuran aplikasi Anda.

Berikut adalah contoh penambahan BII actions.intent.GET_THING di shortcuts.xml:

  <capability android:name="actions.intent.GET_THING">
    <intent
      android:targetPackage="com.example.myapp"
      android:targetClass="com.example.myapp.MySearchActivity">
      <parameter android:name="thing.name" android:key="query" />
    </intent>
  </capability>

Di Activity penelusuran, ekstrak kueri penelusuran dari data tambahan intent dan teruskan ke fungsi penelusuran aplikasi Anda. Dalam kode sebelumnya, kueri penelusuran, yang diteruskan sebagai kunci query, dipetakan ke "thing.name" Parameter BII. Kemudian, lakukan penelusuran dengan kueri tersebut dan tampilkan hasilnya di antarmuka pengguna.

Opsional: Mengirim pintasan untuk Action Aplikasi ke Asisten

Setelah Anda mendefinisikan kemampuan untuk aksi Anda, pengguna bisa meluncurkan tindakan dengan mengucapkan sesuatu seperti, "Ok Google, pesan pizza di Aplikasi Contoh". Asisten bisa menyarankan pintasan Android untuk tindakan Anda kepada pengguna di kali, yang memungkinkan mereka menemukan dan memutar ulang tindakan Anda. Asisten dapat menyarankan pintasan dinamis dan statis.

Untuk mengirim pintasan dinamis ke Asisten, gunakan library Integrasi Pintasan Google. Library Jetpack ini memungkinkan Asisten mengambil pintasan dan menyarankannya kepada pengguna pada waktu yang tepat.

Untuk mengetahui detail selengkapnya, lihat Mengirim pintasan dinamis ke Asisten.

Melihat pratinjau Action Aplikasi

Selama pengembangan dan pengujian, gunakan plugin Asisten Google untuk Android Studio guna menguji apakah Action Aplikasi berfungsi untuk aplikasi Anda. Plugin ini membuat pratinjau Action Aplikasi di Asisten untuk Akun Google Anda. Dengan menggunakan alat pengujian, Anda dapat menguji fulfillment Anda pada perangkat uji fisik atau emulator dengan memberikan parameter input yang ingin Anda terima dari pengguna ke BII.

Saat melihat pratinjau Action Aplikasi, Anda dapat memicu kueri dengan suara di perangkat seluler. Fungsi ini hanya tersedia untuk kueri yang terdaftar dalam referensi BII untuk Action Aplikasi. Gunakan suara memicu hanya untuk demonstrasi, bukan untuk pengujian reguler.

Uji aplikasi Anda dalam mode draf menggunakan alat developer untuk aplikasi Google Play Konsol Google Play sebelum mengirimkan aplikasi untuk ditinjau. Untuk mengetahui informasi selengkapnya tentang cara menggunakan Konsol Google Play untuk men-deploy draf aplikasi Anda, lihat Menyiapkan dan meluncurkan rilis.

Membuat rilis pengujian

Saat Anda siap menguji Action Aplikasi dengan penguji tambahan, buat rilis pengujian internal atau tertutup untuk aplikasi Anda. Secara {i>default<i}, penguji rilis tertutup dapat mengakses Action Aplikasi yang sudah ditinjau dan disetujui.

Untuk memberikan akses pengujian ke semua Action Aplikasi, termasuk tindakan yang tidak disetujui, minta penguji bergabung dengan Google Grup Program Pengembangan Action Aplikasi. Anggota ini memiliki akses ke semua Action Aplikasi dalam mode rilis pengujian internal tanpa harus membuat pratinjau menggunakan alat pengujian tindakan aplikasi. Diperlukan waktu hingga tiga jam setelah bergabung dengan grup agar akses tersedia.

Meminta peninjauan dan deployment Action Aplikasi

Action Aplikasi tidak tersedia untuk pengguna aplikasi yang Anda publikasikan atau pengujian terbuka rilis hingga ditinjau dan disetujui. Peninjauan Action Aplikasi tidak memengaruhi peninjauan aplikasi Android dan status deployment di Google Play. Meskipun jika pengiriman aplikasi Anda disetujui dan dipublikasikan ke Play Store, shortcuts.xml mungkin sedang dalam peninjauan oleh Google. Action Aplikasi tidak berfungsi untuk pengguna akhir hingga peninjauan tersebut juga disetujui.

Saat Anda men-deploy aplikasi, Action Aplikasi akan tetap aktif. Namun, versi yang di-deploy kembali dapat ditinjau oleh Google. Jika versi baru sudah tidak berfungsi dengan baik atau berisi pelanggaran kebijakan, Google berhak untuk menonaktifkan Action Aplikasi untuk aplikasi Anda.

Untuk mengirim Action Aplikasi untuk ditinjau, lakukan hal berikut:

  1. Setujui persyaratan layanan Action Aplikasi di Konsol Google Play (Setelan lanjutan > Action Aplikasi):

    Persyaratan Layanan Action Aplikasi di Konsol Google Play.

  2. Upload aplikasi Anda, yang berisi shortcuts.xml, ke Konsol Google Play seperti biasa untuk publikasi.

  3. Setelah mengupload aplikasi ke Konsol Play, Google akan menghubungi Anda di di akun Konsol Play Anda yang berisi informasi selengkapnya terkait statusnya Aplikasi Anda Peninjauan tindakan. Anda juga dapat menghubungi Dukungan Developer Asisten jika ada pertanyaan terkait status peninjauan Action Aplikasi Anda. Dalam kontak formulir, berikan ID paket aplikasi Anda dan pilih Peninjauan Action Aplikasi di Kotak pilihan Ada yang bisa kami bantu?.

Untuk menggunakan deep link guna meluncurkan Activity menggunakan Action Aplikasi, Activity harus disiapkan dengan URL deep link dan memiliki filter intent yang sesuai di manifes aplikasi Android.

Untuk menguji apakah aktivitas Anda dapat diakses dan dapat dipicu menggunakan Action Aplikasi yang menggunakan deep link, jalankan perintah adb berikut:

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

Contoh:

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

Jika aktivitas Anda tidak diluncurkan secara benar dengan perintah adb, periksa hal berikut:

  • Dalam file manifes aplikasi, aktivitas memiliki android:exported=true, sehingga dapat diluncurkan menggunakan intent dari Asisten Google.
  • Jika menggunakan URL Link Aplikasi, ikuti semua langkah di Menangani Link Aplikasi Android.

Kebijakan Action Aplikasi

Action Aplikasi harus mematuhi kebijakan tertentu untuk membantu memastikan bahwa pengguna yang memicu mereka menerima pengalaman yang diinginkan. Tinjau kebijakan ini sebelum mengirimkan aplikasi Anda untuk memberikan pengalaman pengguna terbaik dan untuk menghindari Play Keterlambatan atau penolakan ulasan toko.

  • Mengarahkan pengguna ke konten yang ditujukan untuk pengguna

    Intent bawaan (BII) Action Aplikasi dan/atau parameter hanya boleh mengarahkan pengguna ke tindakan yang relevan dan dimaksudkan oleh pengguna. Hal ini dapat mencakup konten dalam aplikasi, konten situs web, atau informasi yang ditampilkan dalam potongan atau widget yang dialami pengguna.

    Misalnya, penerapan BII START_EXERCISE membantu pengguna memulai latihan jenis tertentu, misalnya, berlari atau berenang. Satu-satunya pengecualian untuk kebijakan ini adalah saat BII OPEN_APP_FEATURE Anda mengarahkan pengguna ke layar utama aplikasi Anda.

  • Menerapkan BII Action Aplikasi yang relevan

    BII yang diterapkan harus terkait langsung dengan konten aplikasi dan fungsionalitasnya.

    Misalnya, jika aplikasi Anda berada dalam kategori Komunikasi di Play Store, tidak menerapkan BII START_EXERCISE, yang direkomendasikan untuk aplikasi dalam kategori Kesehatan dan Kebugaran.

  • Menerapkan intent kustom yang relevan

    Kueri yang ditentukan untuk intent kustom berkaitan dengan konten aplikasi dan fungsionalitasnya. Contoh potensi pelanggaran kebijakan adalah membuat intent custom.action.intent.GET_RECIPE dengan pola kueri terkait "Tampilkan resep burrito" untuk aplikasi dalam Kategori Play Store Transportasi.