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:
- Oluşturma sayfasındaki talimatları uygulayarak bir
shortcuts.xml
kaynağı oluşturun. statik kısayollar. 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ğeriniactions.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ıncapability
içine yerleştirilmiştir.Parametre eşlemeleri: Her
intent
, amacınextra
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 ederexercise.name
ve toplanan parametre değerinin nasıl iletileceği kullanıcının verileriintent
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ış