Kısayollara özellik ekleme

shortcuts.xml özellikleri, kullanıcıların yapabileceği işlem türlerini tanımlamanıza olanak tanır. yapmanız ve belirli bir görevi doğrudan gerçekleştirmeniz gerekecek.

Örneğin, Google Asistan Uygulama İşlemleri, geliştiricilerin uygulama içi özellikleri yerleşik amaçlara (BII'ler) genişleterek kullanıcıların kontrol edebilir ve bu özellikleri sesli komutlarla kontrol edebilirsiniz. Yetenek aşağıdakileri içerir: İşlemin adı ve uygulamanızda hangi hedefi hedefleyen intent kullanıcının niyetine çözümlenir.

kısayol.xml dosyasında özellikleri tanımlayın

capability öğelerini shortcuts.xml Android uygulama geliştirme projesi. Bir capability öğesini tanımlamak için takip etmek için:

1. Statik kısayollar oluşturma başlıklı makaledeki talimatları uygulayarak bir shortcuts.xml kaynağı oluşturun.

2. Yeteneğinize aşağıdaki gerekli bilgileri ekleyin:

   • Özellik adı: Uygulamanızın desteklemesini istediğiniz işlem. Referans yetenek gerektiren özelliğin bileşen belgeleri tanımlar. Uygulama İşlemleri sesli komutları, özellik adları için BII Action ID BII referansında bulabileceğiniz BII'yi kullanır. Örneğin, GET_THING BII, Action ID değerini actions.intent.GET_THING olarak listeler.

   • Uygulama hedefi: Kullanıcı isteğini yerine getirmek için işlemin başlattığı uygulamadaki hedef. capability içine yerleştirilmiş intent öğelerini kullanarak uygulama hedeflerini tanımlayın.

   • Parametre eşlemeleri: Her intent, intent'in extra verileri olarak iletilecek parametreler içerebilir. Örneğin, Uygulama İşlemleri BII'si kullanıcıların genellikle dönüşüm gerçekleştirdikleri sorgularda sağladığı bilgileri temsil eden alanları BII'yi tetikleyin.

Aşağıdaki örnekte, kullanıcıların bir fitness uygulamasında antrenmana başlamak için Asistan ile sözlü komutlar kullanmasına olanak tanıyan bir BII olan actions.intent.START_EXERCISE için shortcuts.xml'te 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>

Yukarıdaki örnekte <capability> android:name özelliği, değeri START_EXERCISE BII. Bir kullanıcı, Asistan'a "Hey Google, ExampleApp'te bir 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 belirler.
• android:targetClass alanı, hedef etkinliği belirtir: com.example.sampleApp.ExerciseActivity.
• parameter amacı bir BII parametresini desteklediğini beyan eder exercise.name ve toplanan parametre değerinin nasıl iletileceği kullanıcının verileri intent içinde ek veri olarak gösterilir.

Kısayolları bir özellikle ilişkilendirme

Bir olanak tanımladıktan sonra, özel talimatlarla ilişkilendirerek statik veya dinamik kısayollar şeklinde görünür. Kısayollar capability öğesine nasıl bağlanır? kullanılan özelliğe ve anahtar kelimedeki kelime kullanımı, kullanıcının isteği. Örneğin, bir kullanıcı fitness izleme uygulamanızda koşu yapmaya başlamak için Asistan'a "Ok Google, ExampleApp'te koşu başlat" dediğinde. Asistan bir capability örneğini başlatmak için geçerli bir "run" egzersiz varlığı (exercise.name parametresi için)

Kısayolları Uygulama İşlemleri ile ilişkilendirme hakkında daha fazla bilgi için Uygulama İşlemleri'ne genel bakış başlıklı makaleyi inceleyin.