Kısayollara özellik ekleme

shortcuts.xml içindeki özellikler, kullanıcıların uygulamanızı başlatmak ve belirli bir görevi doğrudan gerçekleştirmek için yapabileceği işlem türlerini beyan etmenize olanak tanır. Yetenek, işlemin adından ve uygulamanızda kullanıcı niyetini karşılayan hedefi hedefleyen bir intent öğesinden oluşur.

shortcuts.xml dosyasında özellikleri tanımlama

Android uygulama geliştirme projenizdeki bir shortcuts.xml kaynak dosyasında capability öğelerini tanımlarsınız. capability öğesini tanımlamak için aşağıdakileri yapın:

1. Statik kısayollar oluşturma bölümündeki talimatları uygulayarak bir shortcuts.xml kaynağı oluşturun.

2. Özelliğinize aşağıdaki zorunlu bilgileri ekleyin:

   • Yetenek adı: Uygulamanızın desteklemesini istediğiniz işlem. Yetenek tanımları gerektiren özellik için bileşen belgelerine bakın.

   • Uygulama hedefi: Kullanıcı isteğini yerine getirmek için işlemin başlatıldığı uygulamanızdaki hedef. capability içinde iç içe yerleştirilmiş intent öğelerini kullanarak uygulama hedeflerini tanımlayın.

   • Parametre eşlemeleri: Her intent, intent'in extra verileri olarak iletilecek parametreler içerebilir.

Aşağıdaki örnekte, kullanıcıların bir fitness uygulamasında antrenman başlatmak için Asistan ile sesli komutlar kullanmasına olanak tanıyan bir BII olan actions.intent.START_EXERCISE için shortcuts.xml dosyasındaki bir özellik tanımı gösterilmektedir:

<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>
shortcuts_capability.xml

Önceki örnekte, <capability> android:name özelliği START_EXERCISE BII'yi ifade eder. Kullanıcı, Asistan'a "Ok Google, ÖrnekUygulama'da koşu başlat" diyerek bu BII'yi çağırırsa Asistan, iç içe yerleştirilmiş intent öğesinde sağlanan bilgileri kullanarak kullanıcı isteğini yerine getirir. Bu örnekteki intent, aşağıdaki ayrıntıları tanımlar:

• android:targetPackage, bu intent için hedef uygulama paketini ayarlar.
• android:targetClass alanı, hedef etkinliği belirtir: com.example.sampleApp.ExerciseActivity.
• parameter intent'i, bir BII parametresi exercise.name için destek beyan eder ve kullanıcıdan toplanan parametre değerinin intent içinde ek veri olarak nasıl iletileceğini belirtir.

Kısayolları bir özellikle ilişkilendirme

Bir özelliği tanımladıktan sonra statik veya dinamik kısayolları bu özellikle ilişkilendirerek işlevini genişletebilirsiniz. Kısayolların bir capability ile nasıl bağlantılandırılacağı, uygulanan özelliğe ve kullanıcının isteğinde yer alan kelimelere bağlıdır. Örneğin, bir kullanıcı fitness takip uygulamanızda koşu başlatmak için Asistan'a "Ok Google, ExampleApp'te koşu başlat" dediğinde. Asistan, exercise.name parametresi için geçerli bir "koşu" egzersiz varlığı tanımlayan capability örneğini başlatmak üzere bir kısayol kullanabilir.