Memperluas aplikasi Android ke Asisten Google dengan Action Aplikasi

Action Aplikasi membantu Anda memperluas jangkauan aplikasi Android dengan memungkinkan pengguna meluncurkan fitur tertentu secara langsung dari Asisten Google. Action Aplikasi dibuat di atas deep link aplikasi Anda, memberikan lebih banyak cara bagi pengguna untuk mengakses fitur yang ingin digunakan.

Sebagai developer Android, Anda dapat menerapkan salah satu intent bawaan yang tersedia untuk membantu pengguna melakukan berbagai hal secara lebih cepat dan lebih lancar.

Codelab ini mencakup konsep tingkat menengah untuk mengembangkan dengan Actions on Google. Anda harus memiliki pengalaman mengembangkan aplikasi Android dan menangani deep link sebelumnya untuk mengikuti codelab ini. Developer yang benar-benar baru di Android mungkin ingin memulai salah satu codelab untuk dasar-dasar developer Android.

Yang akan Anda buat

Dalam codelab ini, Anda akan menambahkan fitur-fitur ini ke contoh aplikasi kebugaran Android:

• Pengguna dapat memulai timer olahraga di aplikasi menggunakan Asisten Google.
• Pengguna dapat menghentikan timer olahraga di aplikasi menggunakan Asisten Google.

Yang akan Anda pelajari

• Cara mengetahui apakah Action Aplikasi tepat untuk aplikasi Android Anda.
• Cara menghubungkan intent bawaan dengan aktivitas Android.
• Cara mendapatkan parameter URL deep link untuk aplikasi Android dari Asisten.
• Cara menggunakan inventaris inline untuk memetakan ID ke fungsi aplikasi
• Cara menguji Action Aplikasi di Android Studio.

Yang akan Anda butuhkan

Sebelum melanjutkan, pastikan Anda memiliki alat berikut di lingkungan Anda:

• Terminal untuk menjalankan perintah shell dengan git terpasang.
• Versi terbaru Android Studio.
• Akun Google dengan akses ke Konsol Google Play.
• Perangkat Android fisik untuk menguji Action Aplikasi Anda.

Pemahaman tentang Kotlin dan XML direkomendasikan, meskipun tidak wajib, untuk memahami kode yang digunakan dalam codelab ini.

Perhatian: Pengujian Action Aplikasi harus diselesaikan di perangkat Android fisik. Alih-alih deep link yang diharapkan, mencoba memanggil Action Aplikasi di perangkat virtual menggunakan Asisten dapat menyebabkan respons "Maaf, saya tidak bisa menemukannya".

Action Aplikasi dalam codelab ini hanya akan berhasil memicu bahasa Asisten Google dalam bahasa lokal berikut: en-US, en-GB, en-CA, en-IN, en-BE, en-GS, dan en-AU. Bahasa lain tidak tersedia untuk intent bawaan yang digunakan oleh aplikasi Android dalam codelab ini.

Dalam codelab ini, Anda akan menggunakan perangkat Android untuk menguji Action Aplikasi. Sebelum menguji di perangkat Android fisik, pastikan perangkat terhubung ke mesin pengembangan lokal Anda. Anda harus login ke aplikasi Google di perangkat dan login ke Android Studio menggunakan akun Google yang sama.

Action Aplikasi menghubungkan pengguna dari Asisten Google ke aplikasi Android Anda. Tapi, bagaimana cara kerjanya?

Saat pengguna menyatakan kepada Asisten bahwa mereka ingin menggunakan aplikasi Anda, Asisten mencari Action Aplikasi yang terdaftar ke aplikasi Anda dari file actions.xml. Action Aplikasi dideskripsikan dalam file ini dengan menggunakan kombinasi intent bawaan (yang mendeskripsikan kemampuan aplikasi secara semantik) dan petunjuk fulfillment (seperti template deep link).

File actions.xml berisi informasi berikut untuk setiap Action Aplikasi:

• Intent bawaan yang digunakan Action Aplikasi.
• Bagaimana Action Aplikasi dapat dipenuhi (misalnya, melalui deep link).
• Bagaimana parameter untuk peta intent hingga informasi yang diberikan kepada Asisten oleh pengguna.

Berdasarkan informasi yang diberikan kepada Asisten Google oleh pengguna, Action Aplikasi membuat deep link untuk memenuhi intent. Aktivitas Android Anda kemudian memfilter dan menangani deep link yang disediakan untuk memberikan fungsi yang diinginkan kepada pengguna.

Secara keseluruhan, hasilnya akan menjadi pengalaman pengguna saat Asisten memanggil fungsi aplikasi Anda sebagai respons terhadap kueri pengguna.

Catatan: Codelab ini mencakup Action Aplikasi sederhana yang meluncurkan aktivitas di aplikasi Android Anda. Action Aplikasi juga dapat menyajikan informasi sebagai kartu visual tersemat (Android Slice) yang dapat berinteraksi dengan pengguna di Asisten Google.

Titik awal untuk codelab ini adalah contoh aplikasi kebugaran untuk Android. Di aplikasi, pengguna dapat memulai dan menghentikan timer olahraga, serta melihat informasi tentang rutinitas olahraga mereka.

Mendownload file dasar Anda

Untuk mendapatkan file dasar bagi codelab ini, jalankan perintah berikut untuk meng-clone repositori GitHub:

git clone --branch codelab-start https://github.com/actions-on-google/appactions-fitness-kotlin.git

Menggunakan opsi --branch codelab-start, periksa cabang tempat codelab ini dimulai.

Opsional: Jika Anda ingin mereferensikan project yang sudah selesai, cabang codelab-complete berisi tampilan aplikasi kebugaran Anda di akhir codelab ini.

Setelah meng-clone repositori, buka di Android Studio:

1. Dalam dialog Welcome to Android Studio, klik Open an existing Android Studio project (jika Anda sudah membuka project, tutup terlebih dahulu).
2. Untuk mulai mengerjakan aplikasi kebugaran, cari dan pilih folder tempat Anda meng-clone repositori.

Mengubah ID aplikasi Android

Saat Anda menerapkan Action Aplikasi untuk aplikasi kebugaran, Anda akan diberi tugas dengan pengujian input menggunakan plugin Android Studio. Anda akan menginstal plugin ini nanti di codelab, tapi Anda tidak akan dapat menggunakan alat pengujian hingga aplikasi diupload ke project di Konsol Google Play.

Untuk membuat versi contoh aplikasi kebugaran yang unik di konsol, ubah ID aplikasi yang tercantum di konfigurasi Android default file app/build.gradle Anda:

build.gradle

android {
...
    defaultConfig {
        applicationId "com.MYUNIQUENAME.android.fitactions"
    ...
    }
}

Ganti "MyUNIQUENAME" di applicationId dengan sesuatu yang unik untuk Anda. Tindakan ini akan mengubah nama paket dan mencegah masalah "Nama paket duplikat" saat mengupload ke Konsol Play.

Mencoba aplikasi

Sebelum melakukan perubahan lain pada aplikasi, sebaiknya dapatkan gambaran tentang apa yang dapat dilakukan oleh aplikasi contoh. Cobalah jalankan aplikasi tersebut di emulator:

1. Di Android Studio, pilih Run > Run app atau klik Run di toolbar.
2. Pada dialog Select Deployment Target, pilih perangkat virtual, lalu klik OK. Versi OS yang direkomendasikan adalah Android 8 (API level 26) atau lebih tinggi, meskipun Action dapat berjalan di perangkat Android 5 (API level 21).

Emulator memulai dan melakukan booting seperti perangkat fisik, sehingga perlu waktu agak lama bergantung pada kecepatan komputer Anda. Setelah aplikasi dibuat dan emulator sudah siap, Android Studio akan mengupload aplikasi itu ke emulator dan menjalankannya.

Catatan: Anda dapat menemukan informasi terbaru tentang penggunaan Perangkat Virtual Android dalam dokumentasi Android Studio. Silakan mengacu ke sana jika Anda mengalami masalah dalam mengikuti langkah-langkah yang tercantum di atas.

Jelajahi aplikasi secara singkat untuk melihat apa yang dapat dilakukannya. Mengetuk ikon Run akan memulai timer olahraga, dan mengetuk ikon X akan menghentikan timer. Ini adalah dua tugas yang akan Anda aktifkan dengan Action Aplikasi.

Ulangi langkah-langkah di atas pada perangkat pengujian untuk mengonfirmasi bahwa aplikasi berfungsi dengan cara yang sama di kedua permukaan. Sebelum melanjutkan, siapkan dan verifikasi bahwa Asisten berfungsi di perangkat fisik Anda dengan menekan lama tombol Beranda. Anda harus login ke Asisten di perangkat pengujian jika belum melakukannya.

Mengupload ke Konsol Play

Buat aplikasi Anda di Android Studio dan upload ke Konsol Play sebagai rilis internal. Mengupload aplikasi adalah prasyarat untuk menggunakan alat pengujian Action Aplikasi di Android Studio.

Di Android Studio, lakukan langkah-langkah berikut:

1. Buka Build > Generate Signed Bundle / APK.
2. Pilih "Android App Bundle" lalu klik Next.
3. Masukkan detail untuk menandatangani aplikasi Anda secara digital, lalu klik Next.
4. Pilih varian build "rilis" lalu klik Finish.

Di Konsol Google Play, upload app bundle yang baru saja dibuat sebagai aplikasi baru:

1. Di halaman Semua aplikasi, klik Buat aplikasi.
2. Beri nama aplikasi yang Anda inginkan dan klik Buat aplikasi. Untuk codelab ini, Anda tidak perlu mengisi informasi aplikasi apa pun setelah aplikasi dibuat.
3. Dari menu sidebar, buka Rilis dan cari halaman Pengujian internal.
4. Klik Buat rilis baru di halaman Pengujian internal.
5. Di panel App bundle dan APK, upload file AAB yang Anda buat sebelumnya (kemungkinan ada di direktori app/release).
6. Klik Simpan.

Setelah berhasil mengupload aplikasi ke Konsol Play, saatnya untuk kembali ke Android Studio.

Catatan: Lihat pemecahan masalah jika Anda mengalami masalah saat mengupload aplikasi ke Konsol Google Play.

Menginstal plugin uji

Asisten Google perlu mengetahui Action Aplikasi yang terdaftar di aplikasi Anda, jadi Anda perlu mengomunikasikan informasi tersebut. Selama pengembangan, Anda melakukannya dengan menggunakan plugin Android Studio "alat pengujian Action Aplikasi".

Jika Anda belum memiliki plugin tersebut, instal:

1. Buka File > Setelan (Android Studio > Preferensi di MacOS).
2. Di bagian Plugin, buka Marketplace dan telusuri "Alat pengujian Action Aplikasi".
3. Instal alat tersebut lalu mulai ulang Android Studio.

Catatan: Plugin pengujian mengirimkan informasi ke Asisten melalui aplikasi Google di perangkat Android Anda. Perangkat pengujian Anda memerlukan akses ke Play Store untuk mengupdate aplikasi Google sebelum Action Aplikasi dapat berfungsi dengan baik.

Untuk menyiapkan Action Aplikasi, Anda perlu menemukan intent bawaan yang memetakan ke fungsi yang dilakukan oleh aplikasi Android Anda. Halaman referensi intent bawaan mencantumkan intent bawaan yang tersedia untuk Asisten Google, yang masing-masing mencontohkan cara umumnya pengguna mengekspresikan tugas yang berusaha dilakukan.

Dalam referensi ini, intent bawaan yang bisa dipenuhi oleh Action Aplikasi dikelompokkan berdasarkan kategori dan fungsi.

Poin Utama: Memilih intent bawaan yang sesuai dengan apa yang ingin pengguna lakukan adalah bagian penting dari penerapan Action Aplikasi.

Untuk codelab ini, Anda menerapkan dua intent bawaan untuk membantu pengguna:

• Mulai pemantauan olahraga (actions.intent.START_EXERCISE)
• Hentikan pemantauan olahraga (actions.intent.STOP_EXERCISE)

Proses ini melibatkan penyiapan deep link, menentukan Action Aplikasi di resource XML aplikasi, lalu menghubungkan keduanya.

Menerapkan deep link

Deep link membawa pengguna langsung ke konten, meneruskan informasi dari intent ke aplikasi dalam prosesnya. Secara default, Asisten menggunakan deep link untuk memenuhi intent dan meneruskan parameter ke aplikasi. Untuk codelab ini, deep link masuk menggunakan host "fit-actions.firebaseapp.com" dan skema "https".

Di file manifes Android, tambahkan filter intent untuk aktivitas utama guna menentukan deep link yang didukung:

AndroidManifest.xml

<activity android:name="com.devrel.android.fitactions.FitMainActivity" ...>
    ... // Other intent filters

    <!-- Define your supported deeplinks -->
    <intent-filter
        android:autoVerify="true"
        tools:targetApi="m">

        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:host="fit-actions.firebaseapp.com"
            android:scheme="https" />
    </intent-filter>
</activity>

Sekarang di aktivitas utama, tambahkan fungsi berikut untuk menentukan perilaku bagi deep link yang masuk:

FitMainActivity.kt

private fun handleDeepLink(data: Uri?) {
    when (data?.path) {
        DeepLink.START -> {
            // Get the parameter defined as "exerciseType" and add it to the fragment arguments
            val exerciseType = data.getQueryParameter(DeepLink.Params.ACTIVITY_TYPE).orEmpty()
            val type = FitActivity.Type.find(exerciseType)
            val arguments = Bundle().apply {
                putSerializable(FitTrackingFragment.PARAM_TYPE, type)
            }

            updateView(FitTrackingFragment::class.java, arguments)
        }
        DeepLink.STOP -> {
            // Stop the tracking service if any and return to home screen.
            stopService(Intent(this, FitTrackingService::class.java))
            updateView(FitStatsFragment::class.java)
        }
        else -> {
            // Path is not supported or invalid, start normal flow.
            showDefaultView()
        }
    }
}

DeepLink.START dan DeepLink.STOP ditetapkan sebagai konstanta di aplikasi contoh, dan dipetakan ke jalur yang sesuai dari deep link yang masuk. Dalam kasus DeepLink.START, pengendali juga mendapatkan argumen yang masuk melalui parameter URL deep link.

Sekarang, update fungsi handleIntent dari file yang sama untuk menggunakan pengendali deep link:

FitMainActivity.kt

private fun Intent.handleIntent() {
    when (action) {
        // When the action is triggered by a deep-link, Intent.ACTION_VIEW will be used
        Intent.ACTION_VIEW -> handleDeepLink(data)
        // Otherwise start the app as you would normally do.
        else -> showDefaultView()
    }
}

Sekarang, saat aplikasi memfilter intent format "https://fit-actions.firebaseapp.com/start", timer olahraga akan dimulai.

Jika sudah terbiasa dengan Android Debug Bridge (adb), Anda dapat menguji pengendali deep link pada perangkat yang berjalan. Untuk melakukannya, update aplikasi di perangkat Anda, lalu gunakan perintah shell berikut:

adb shell am start -a android.intent.action.VIEW -d "https://fit-actions.firebaseapp.com/start"

Agar Action Aplikasi dapat berfungsi, Asisten Google perlu mengetahui Action Aplikasi mana yang terdaftar ke aplikasi Anda. Informasi ini Anda sampaikan dengan mengupload file actions.xml ke Konsol Play sebagai bagian dari paket Android Anda.

Hanya diperlukan beberapa langkah untuk membuat resource baru dan mereferensikannya:

1. Buat actions.xml untuk menetapkan intent bawaan mana yang harus dihubungkan dan parameter apa yang diperlukan.
2. Petakan parameter intent bawaan ke parameter deep link dalam aktivitas Anda.
3. Tambahkan referensi ke file actions.xml Anda di AndroidManifest.xml.

Membuat actions.xml

Untuk mendeskripsikan Action Aplikasi yang didukung oleh aplikasi, Anda membuat file XML baru bernama actions.xml di app/src/main/res/xml.

Di Android Studio, lakukan langkah-langkah berikut:

1. BukaFile >Baru >XML >File XML Action Aplikasi.
2. Masukkan "action" sebagai Nama File Action.
3. Klik Finish untuk membuat file actions.xml baru dan menambahkan referensi ke file tersebut di AndroidManifest.xml.

Setelah file baru dibuat, ganti konten actions.xml dengan kode berikut:

actions.xml

<?xml version="1.0" encoding="utf-8"?>

<actions>
    <action intentName="actions.intent.START_EXERCISE">
        <fulfillment urlTemplate="https://fit-actions.firebaseapp.com/start{?exerciseType}">
            <parameter-mapping
                intentParameter="exercise.name"
                urlParameter="exerciseType" />
        </fulfillment>
    </action>

    <action intentName="actions.intent.STOP_EXERCISE">
        <fulfillment urlTemplate="https://fit-actions.firebaseapp.com/stop" />
    </action>
</actions>

Pada kode di atas, Anda menggunakan elemen untuk menentukan Action Aplikasi guna memulai dan menghentikan timer olahraga di aplikasi. Atribut intentName sesuai dengan dua intent bawaan yang Anda penuhi menggunakan Action Aplikasi, dan elemen memberi tahu Asisten cara menggunakan aplikasi Anda untuk mencapai tindakan.

Di sini, kedua tindakan tersebut dipenuhi dengan mengkonstruksi deep link menggunakan atribut urlTemplate. Template URL menggunakan host dan skema yang Anda tetapkan untuk deep link di file AndroidManifest.xml. Path di setiap template URL sesuai dengan fungsi handleDeepLink (ditambahkan sebelumnya ke aktivitas utama).

Perhatikan bahwa untuk memulai timer, Anda juga memetakan parameter exercise.name dari intent bawaan ke parameter URL exerciseType. Ini memungkinkan pengendali deep link Anda mendapatkan argumen untuk logika bisnisnya dari Asisten.

Mengonfirmasikan bahwa manifes Android Anda mereferensikan action.xml

Di langkah sebelumnya, Android Studio menambahkan referensi ke file actions.xml di AndroidManifest.xml. Verifikasi hal ini dengan memeriksa elemen berikut di manifes Android:

AndroidManifest.xml

<application>
    ...

    <meta-data
        android:name="com.google.android.actions"
        android:resource="@xml/actions" />
</application>

Jika Anda melihat elemen di atas dalam file manifes, lanjutkan ke pengujian Action Aplikasi.

Jika Anda tidak melihat elemen di atas dalam file manifes, tambahkan elemen tersebut.

Uji Action Aplikasi

Saatnya untuk mencoba Action Aplikasi di perangkat uji!

Hubungkan perangkat pengujian dan gunakan alat pengujian untuk menguji Action Aplikasi:

1. Buka Alat > Action Aplikasi > Alat Pengujian Action Aplikasi. Anda mungkin diminta untuk login ke Android Studio. Gunakan akun yang sama yang digunakan sebelumnya dengan Konsol Google Play.
2. Di kolom Invocation Name, masukkan "Action Fit".
3. Jika bahasa Asisten Anda bukan "Bahasa Inggris (AS)", masukkan bahasa yang cocok dengan bahasa Asisten di kolom Lokal.
4. Klik Create Preview.
5. Menggunakan Konfigurasikan menu drop-down, pilih intent bawaan yang ingin Anda uji.
6. Klik Run. Jika diberi opsi untuk membuka dengan Google, pilih "Selalu" untuk mengizinkan Asisten membuka link dukungan (Anda dapat mengubahnya nanti di setelan aplikasi).

Saat alat uji Action Aplikasi membuat atau mengupdate pratinjau Action Aplikasi, hal ini dilakukan untuk satu akun Google, mendaftarkan Action Aplikasi yang Anda tentukan untuk sementara. Pratinjau tersebut memungkinkan Asisten mengenali Action Aplikasi Anda sebelum men-deploy versi produksi aplikasi ke Konsol Google Play.

Setelah fitur pengujian mengambil intent bawaan untuk aplikasi, Anda dapat langsung memberikan intent dengan nilai parameter dan memicu Action Aplikasi dari Android Studio!

Sebagai alternatif, Anda dapat menggunakan nama panggilan langsung di aplikasi Asisten pada perangkat untuk mencoba Action Aplikasi. Misalnya, Anda dapat mengucapkan "Ok Google, mulai jalankan di Action Fit" untuk meluncurkan Action Aplikasi yang memulai timer olahraga.

Tips: Anda dapat mengetik perintah ke Asisten Google dengan menekan lama tombol Beranda, lalu mengetuk ikon Keyboard yang muncul saat tidak ada audio yang terdeteksi.

Sekarang Anda dapat memulai dan menghentikan timer olahraga di aplikasi kebugaran melalui Asisten Google, tetapi Anda mungkin menyadari bahwa hanya olahraga tertentu yang akan dikenali. Permintaan seperti "Mulai berenang di Action Fit" atau "Mulai mendaki di Action Fit" mengarah ke timer yang dimulai dengan teks "Mulai tidak dikenal di...".

Itu karena satu-satunya jenis olahraga yang saat ini didukung oleh aplikasi contoh adalah "Lari", "Bersepeda", dan "Jalan kaki". Bagaimana cara untuk lebih mengakomodasi pengguna yang ingin menggunakan aplikasi untuk memantau olahraga lainnya?

Untuk aplikasi ini, Anda dapat meningkatkan jumlah olahraga yang tersedia dalam beberapa cara:

• Menambahkan dukungan aplikasi untuk jenis olahraga lainnya seperti berenang dan mendaki (dibatasi oleh nilai kolom teks yang didukung untuk intent bawaan actions.intent.START_EXERCISE)
• Petakan jenis olahraga yang didukung lainnya, seperti "hiking", ke olahraga yang didukung di aplikasi seperti "jalan kaki"

Tips: Gunakan Action Aplikasi sebagai cara untuk membuat pengguna memulai proses—hindari membuat frasa yang sangat rumit. Meskipun aplikasi Anda dapat memaketkan langkah-langkah tugas bersama dengan Action Aplikasi, pengguna mungkin tidak memberikan semua informasi yang Anda butuhkan sekaligus.

Jika Anda menambahkan dukungan untuk lebih banyak jenis olahraga, Anda dapat menghubungkan ke lebih banyak jalur dalam aplikasi Anda berdasarkan olahraga yang ingin dilakukan pengguna. Itu adalah salah satu cara untuk membantu pengguna, dan ini adalah pilihan yang tepat jika aplikasi Anda dapat melakukan berbagai tugas untuk olahraga yang berbeda.

Untuk aplikasi kebugaran, Anda dapat mengambil opsi kedua untuk membuat Asisten Google lebih mengakomodasi dengan segera. Begitu Anda melakukannya, pengguna akan dapat memulai timer menggunakan kueri yang berisi nilai kolom teks lain yang didukung. Dalam codelab ini, Anda akan menggunakan inventaris inline untuk memetakan "Mulai mendaki" ke fungsionalitas aplikasi untuk "Mulai berjalan".

Inventaris inline

Inventaris inline menentukan entitas tertentu yang diharapkan aplikasi untuk disertakan pengguna saat memicu Action Aplikasi dengan Asisten. Anda menambahkan inventaris inline di file actions.xml untuk langsung membuat daftar opsi yang didukung bagi pengguna. Item inventaris dikelompokkan dalam elemen , dan definisi action dapat mereferensikan kumpulan entitas untuk digunakan untuk parameter pemetaan.

Seperti yang telah disebutkan sebelumnya, aplikasi contoh memiliki fungsi untuk mendukung "Lari", "Bersepeda", dan "Jalan kaki". Buat kumpulan entitas dan referensikan ke actions.intent.START_EXERCISE sehingga aplikasi Anda hanya perlu menggunakan ID entitas untuk deep linking:

actions.xml

<actions>
    <action intentName="actions.intent.START_EXERCISE">
        ...

        <!-- Map a parameter to an entity set reference -->
        <parameter name="exercise.name">
            <entity-set-reference entitySetId="ExerciseEntitySet" />
        </parameter>
    </action>
    ...

    <!-- Define an inline inventory -->
    <!-- This sample maps supported entities with the class FitActivity.Type -->
    <entity-set entitySetId="ExerciseEntitySet">
        <entity
            name="@string/activity_running"
            identifier="RUNNING" />
        <entity
            name="@string/activity_walking"
            identifier="WALKING" />
        <entity
            name="@string/activity_hiking"
            identifier="WALKING" />
        <entity
            name="@string/activity_cycling"
            identifier="CYCLING" />
    </entity-set>
</actions>

Setiap elemen dalam inventaris inline mewakili pencocokan unik untuk kueri pengguna. Entitas memungkinkan Asisten untuk membedakan antara input yang didukung seperti berlari, berjalan kaki, dan bersepeda. Fitur ini sangat berguna saat Anda ingin Asisten mengenali informasi tertentu yang spesifik untuk aplikasi Anda, seperti item menu atau layanan.

Dengan menambahkan entitas untuk string "hiking", Anda memungkinkan pendaki memanfaatkan fungsionalitas yang sudah Anda buat untuk berjalan kaki.

Catatan: Dalam contoh kebugaran ini, intent bawaan actions.intent.START_EXERCISE memberikan nilai kolom teks yang didukung yang sangat cocok dengan string dalam logika bisnis aplikasi. Pikirkan nilai kolom teks yang didukung untuk intent bawaan sebagai nilai inventaris inline yang telah ditentukan sebelumnya, yang dapat dipetakan ke URL atau ID untuk deep linking. Akibatnya, entitas terutama bertindak sebagai lapisan pemetaan untuk nilai kolom teks tersebut dan tidak benar-benar diperlukan untuk mengidentifikasi string tersebut secara unik.

Menguji inventaris Anda

Dalam alat pengujian, membuat atau mengupdate pratinjau akan mengambil intent bawaan yang terdaftar untuk aplikasi Anda. Anda kemudian dapat secara langsung menyediakan intent dengan nilai parameter dan memicu Action Aplikasi dari Android Studio.

Coba inventaris Anda di alat uji Action Aplikasi:

1. Klik Update Preview.
2. Dari menu drop-down Configure, pilih "actions.intent.START_EXECISE".
3. Ketik "hiking" ke dalam kolom exercise.name.
4. Pilih perangkat dari menu drop-down Select Target Device.
5. Klik Run.

Selamat!

Anda kini telah mencakup keterampilan yang diperlukan untuk menambahkan Action Aplikasi ke aplikasi Android.

Yang telah kita bahas

• Cara mengidentifikasi aktivitas Android yang memiliki intent bawaan yang sesuai yang dapat dipicu pengguna melalui Action Aplikasi.
• Cara meneruskan parameter dari intent bawaan ke aplikasi Android.
• Cara menggunakan inventaris inline untuk memetakan nilai yang didukung ke ID fungsi aplikasi.
• Cara menguji Action Aplikasi di Android Studio.

Langkah berikutnya

Dari sini, Anda dapat mencoba menyempurnakan aplikasi kebugaran. Untuk memberi Anda beberapa inspirasi, kami telah menyediakan versi aplikasi yang diperluas di cabang repo master di GitHub. Versi yang diperluas menggunakan Android Slice untuk menyajikan informasi olahraga tambahan melalui Asisten. Ini juga menggabungkan persyaratan deployment Action Aplikasi untuk aplikasi Android produksi.

Untuk mempelajari lebih lanjut tentang Actions on Google, pelajari referensi berikut:

• action.google.com: Situs dokumentasi resmi untuk Actions on Google.
• Indeks contoh Action Aplikasi: Aplikasi contoh dan kode untuk menjelajahi kemampuan Action Aplikasi.
• Repo GitHub Actions on Google: Kode contoh dan library.
• r/GoogleAssistenDev: Komunitas Reddit resmi untuk developer yang bekerja dengan Asisten Google.

Ikuti kami di Twitter @ActionsOnGoogle untuk mengikuti terus pengumuman terbaru kami, dan kirim tweet ke #AoGDevs untuk membagikan yang telah Anda buat.

Survei masukan

Sebelum melanjutkan, isi formulir ini untuk membantu kami meningkatkan codelab. Beri tahu kami jika Anda mengalami masalah, memerlukan lebih banyak informasi untuk menyelesaikan langkah-langkah, atau bahkan jika semuanya berjalan lancar.