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. Oluşturma sayfasındaki talimatları uygulayarak bir shortcuts.xml kaynağı oluşturun. statik kısayollar.

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'nde sesle etkinleştirilen komutlar BII'yi kullanır Action ID BII referansında bulabileceğiniz özellik adlarını inceleyin. Örneğin, GET_THING BII, Action ID değerini actions.intent.GET_THING olarak listeler.

   • Uygulama hedefi: Uygulamanızda işlemin başlatıldığı hedef kullanıcı isteğini yerine getirmesi gerekir. intent öğelerini kullanarak uygulama hedeflerini tanımlayın capability içine yerleştirilmiştir.

   • Parametre eşlemeleri: Her intent, amacın extra verisi olarak iletildi. Ö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, shortcuts.xml işlevindeki bir özellik tanımı gösterilmektedir actions.intent.START_EXERCISE için bir BII (kullanıcıların sesli arama özelliğini kullanmalarına olanak tanıyan bir BII) fitness uygulamasında antrenmana başlamak için Asistan ile komutlar:

<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. Kullanıcı, Asistan'a "Ok Google, ExampleApp'te çalıştırma başlat" yazıyorsa Asistan, kullanıcı isteğini iç içe yerleştirilmiş intent öğesinde sağlanan bilgiler. Bu örnekteki intent , aşağıdaki ayrıntıları tanımlar:

• android:targetPackage, bunun için hedef uygulama paketini ayarlar isteyebilirsiniz.
• 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 öbeklerine kullanıcının isteği. Örneğin bir kullanıcı, fitness takibinizde koşuya başladığında Asistan'a "Ok Google, ExampleApp'te çalıştırma başlat" diyerek uygulamayı ekleyebilirsiniz. Asistan bir capability örneğini başlatmak için geçerli bir "run" (koşu) egzersiz varlığı (exercise.name parametresi için)

Kısayolları uygulama işlemleri ile ilişkilendirme hakkında daha fazla bilgi için bkz. Uygulama İşlemlere genel bakış