Kısayollara özellik ekleme

shortcuts.xml'daki özellikler, kullanıcıların uygulamanızı başlatmak ve doğrudan belirli bir görevi gerçekleştirmek için yapabileceği işlem türlerini bildirmenize olanak tanır. Bir özellik, işlemin adından ve kullanıcının amacını karşılayan uygulamanızdaki hedefi intent hedefleyen bir öğeden oluşur.

shortcuts.xml dosyasında özellikleri tanımlama

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

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

2. Aşağıdaki zorunlu bilgileri capability nesnenize ekleyin:

   • Capability adı: Uygulamanızın desteklemesini istediğiniz işlem. Özellik tanımları gerektiren özelliklerle ilgili bileşen belgelerine bakın.

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

   • Parametre eşlemeleri: Her intent, amaç extra verisi olarak iletilecek parametreler içerebilir.

Aşağıdaki örnekte, shortcuts.xml içinde bir capability nesnesi tanımı gösterilmektedir.actions.intent.START_EXERCISE, kullanıcıların fitness uygulamasında antrenman başlatmak için Asistan ile sözlü komutlar kullanmasına olanak tanıyan bir BII'dir:

<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>

Önceki örnekte, <capability> android:name özelliği START_EXERCISE BII'yi ifade eder. Kullanıcı, Asistan'a "Hey Google, ExampleApp'te koşu başlat" diye sorarak 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 amaç için hedef uygulama paketini ayarlar.
• android:targetClass alanı, hedef etkinliği belirtir: com.example.sampleApp.ExerciseActivity.
• Amaç parameter, bir BII parametresinin exercise.name desteklendiğini ve kullanıcıdan toplanan parametre değerinin intent içinde nasıl ek veri olarak 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şlevselliğini genişletebilirsiniz. Kısayolların capability bağlanma şekli, uygulanan özelliğe ve kullanıcının isteğinde yer alan kelimelere bağlıdır. Örneğin, bir kullanıcı Asistan'a "Ok Google, ExampleApp'te koşu başlat" diyerek fitness takip uygulamanızda koşuya başladığında. Asistan , exercise.name parametresi için geçerli bir "koşu" egzersiz öğesini tanımlayan bir capability örneğini başlatmak için kısayol kullanabilir.