Menambahkan kemampuan ke pintasan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Kemampuan di shortcuts.xml memungkinkan Anda mendeklarasikan jenis tindakan yang dapat dilakukan pengguna untuk meluncurkan aplikasi dan langsung melakukan tugas tertentu.
Misalnya, Action Aplikasi Asisten Google menggunakan kemampuan untuk memungkinkan developer memperluas fitur dalam aplikasi ke intent bawaan (BII), yang memungkinkan pengguna mengaktifkan dan mengontrol fitur tersebut menggunakan perintah lisan. Kemampuan terdiri dari
nama tindakan dan intent yang menargetkan tujuan di aplikasi Anda yang
menyelesaikan intent pengguna.
Menentukan kemampuan dalam shortcuts.xml
Anda menentukan elemen capability dalam file referensi shortcuts.xml dalam
project pengembangan aplikasi Android. Untuk menentukan elemen capability, lakukan hal
berikut:
- Buat resource
shortcuts.xml dengan mengikuti petunjuk di Membuat
pintasan statis.
Sertakan informasi yang diperlukan berikut ini dalam kemampuan Anda:
Nama kemampuan: tindakan yang Anda inginkan agar didukung dalam aplikasi. Lihat
dokumentasi komponen untuk fitur yang memerlukan definisi
kemampuan. Perintah yang diaktifkan suara Action Aplikasi menggunakan BII Action ID
untuk nama kemampuan, yang dapat Anda temukan di referensi BII. Misalnya,
BII GET_THING mencantumkan Action ID sebagai actions.intent.GET_THING.
Tujuan aplikasi: tujuan di aplikasi Anda diluncurkan tindakan untuk
memenuhi permintaan pengguna. Menentukan tujuan aplikasi menggunakan elemen
intent yang bertingkat di dalam capability.
Pemetaan parameter: setiap intent dapat berisi parameter yang akan
diteruskan sebagai data extra dari intent. Misalnya, setiap BII Action Aplikasi
mencakup kolom yang mewakili informasi yang sering disediakan pengguna dalam kueri yang
memicu BII.
Contoh berikut menunjukkan definisi kemampuan di shortcuts.xml
untuk actions.intent.START_EXERCISE, BII yang memungkinkan pengguna menggunakan perintah lisan
dengan Asisten untuk memulai latihan fisik di aplikasi kebugaran:
<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:targetPackage="com.example.sampleApp"
android:targetClass="com.example.sampleApp.ExerciseActivity">
<parameter
android:name="exercise.name"
android:key="exerciseType"/>
</intent>
</capability>
</shortcuts>
Pada contoh sebelumnya, atribut <capability> android:name mengacu pada
BII START_EXERCISE. Jika pengguna memanggil BII ini dengan meminta Asisten, "Ok
Google, mulai berlari di ExampleApp", Asisten akan memenuhi permintaan pengguna menggunakan
informasi yang diberikan di elemen intent bertingkat. intent dalam sampel ini
menentukan detail berikut:
android:targetPackage menetapkan paket aplikasi target untuk
intent ini.- Kolom
android:targetClass menentukan aktivitas tujuan:
com.example.sampleApp.ExerciseActivity.
- Intent
parameter menyatakan dukungan untuk parameter BII
exercise.name dan cara meneruskan nilai parameter—yang dikumpulkan
dari pengguna—sebagai data tambahan di intent.
Mengaitkan pintasan dengan kemampuan
Setelah menentukan kemampuan, Anda dapat memperluas fungsinya dengan mengaitkan
pintasan statis atau dinamis. Cara pintasan ditautkan ke capability
bergantung pada fitur yang diterapkan dan ucapan yang sebenarnya yang disertakan dalam
permintaan pengguna. Misalnya, saat pengguna mulai berlari di aplikasi pelacakan kebugaran
Anda dengan meminta Asisten, "Ok Google, mulai berlari di ExampleApp". Asisten
dapat menggunakan pintasan untuk meluncurkan instance capability yang menentukan entitas
olahraga yang valid dari "berlari" untuk parameter exercise.name.
Untuk mengetahui informasi selengkapnya tentang cara mengaitkan pintasan ke Action Aplikasi, lihat Ringkasan Action Aplikasi.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-27 UTC."],[],[],null,["# Add capabilities to shortcuts\n\nCapabilities in `shortcuts.xml` let you declare the types of actions users can\ntake to launch your app and directly perform a specific task.\n\nFor example, Google Assistant App Actions use capabilities to let developers\nextend in-app features to [built-in intents](//developers.google.com/assistant/app/intents) (BIIs), letting users activate\nand control those features using spoken commands. A capability consists of the\nname of the action and an `intent` targeting the destination in your app that\nresolves the user intent.\n\nDefine capabilities in shortcuts.xml\n------------------------------------\n\nYou define `capability` elements in a `shortcuts.xml` resource file in your\nAndroid app development project. To define a `capability` element, do the\nfollowing:\n\n1. Create a `shortcuts.xml` resource by following the instructions in [Create\n static shortcuts](//develop/ui/views/launch/shortcuts/creating-shortcuts#static).\n2. Include the following required information in your capability:\n\n - **Capability name:** the action you want your app to support. Refer to\n the component documentation for the feature that requires capability\n definitions. App Actions voice-enabled commands use the BII `Action ID`\n for capability names, which you can find in [BII reference](//developers.google.com/assistant/app/reference/built-in-intents). For example,\n the [`GET_THING`](//developers.google.com/assistant/app/reference/built-in-intents/common/get-thing) BII lists its `Action ID` as `actions.intent.GET_THING`.\n\n - **App destination:** the destination in your app the action launches to\n fulfill the user request. Define app destinations using `intent` elements\n nested within the `capability`.\n\n - **Parameter mappings:** each `intent` might contain parameters to be\n passed as `extra` data of the intent. For example, each App Actions BII\n includes fields representing information users often provide in queries that\n trigger the BII.\n\nThe following example demonstrates a capability definition in `shortcuts.xml`\nfor [`actions.intent.START_EXERCISE`](//developers.google.com/assistant/app/reference/built-in-intents/health-and-fitness/start-exercise), a BII that lets users use spoken\ncommands with Assistant to begin a workout in a fitness app: \n\n \u003cshortcuts xmlns:android=\"http://schemas.android.com/apk/res/android\"\u003e\n \u003ccapability android:name=\"actions.intent.START_EXERCISE\"\u003e\n \u003cintent\n android:action=\"android.intent.action.VIEW\"\n android:targetPackage=\"com.example.sampleApp\"\n android:targetClass=\"com.example.sampleApp.ExerciseActivity\"\u003e\n \u003cparameter\n android:name=\"exercise.name\"\n android:key=\"exerciseType\"/\u003e\n \u003c/intent\u003e\n \u003c/capability\u003e\n \u003c/shortcuts\u003e\n\nIn the preceding example, the `\u003ccapability\u003e` `android:name` attribute refers to\nthe `START_EXERCISE` BII. If a user invokes this BII by asking Assistant, *\"Hey\nGoogle, start a run in ExampleApp,\"* Assistant fulfills the user request using\ninformation provided in the nested `intent` element. The `intent` in this sample\ndefines the following details:\n\n- The `android:targetPackage` sets the target application package for this intent.\n- The `android:targetClass` field specifies the destination activity: `com.example.sampleApp.ExerciseActivity`.\n- The intent `parameter` declares support for a BII parameter [`exercise.name`](//developers.google.com/assistant/app/reference/built-in-intents/health-and-fitness/start-exercise#recommended-fields) and how to pass the parameter value---collected from the user---as extra data in the `intent`.\n\nAssociate shortcuts with a capability\n-------------------------------------\n\nOnce you define a capability, you can extend its functionality by associating\nstatic or dynamic shortcuts with it. How shortcuts are linked to a `capability`\ndepends on the feature being implemented and the actual words included in a\nuser's request. For example, when a user begins a run in your fitness tracking\napp by asking Assistant, *\"Hey Google, start a run in ExampleApp.\"* Assistant\ncan use a shortcut to launch an instance of a `capability` that defines a valid\nexercise entity of \"run\" for the `exercise.name` parameter.\n\nFor more information about associating shortcuts to App Actions, see [App\nActions overview](//developers.google.com/assistant/app)."]]
