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 gerçekleştirebilecekleri işlem türlerini bildirmenizi sağlar.
Örneğin, Google Asistan Uygulama İşlemleri, geliştiricilerin uygulama içi özellikleri yerleşik amaçlara (BII'ler) genişletmesine olanak tanır. Böylece kullanıcılar, sesli komutları kullanarak bu özellikleri etkinleştirip kontrol edebilir. Özellik, işlemin adı ve uygulamanızdaki kullanıcı amacını çözümleyen hedefi hedefleyen bir intent
değerinden oluşur.
shortcuts.xml dosyasında özellikleri tanımlayın
capability
öğelerini Android uygulama geliştirme projenizdeki bir shortcuts.xml
kaynak dosyasında tanımlarsınız. Bir capability
öğesi tanımlamak için aşağıdakileri yapın:
- Statik kısayollar oluşturma bölümündeki talimatları uygulayarak bir
shortcuts.xml
kaynağı oluşturun. Aşağıdaki gerekli bilgileri kendi kapasitenize dahil edin:
Yetenek adı: Uygulamanızın desteklemesini istediğiniz işlem. Yetenek tanımlarını gerektiren özellik için bileşen belgelerine bakın. Uygulama İşlemleri sesli komutlarında, özellik adları için BII
Action ID
kullanılır. Bunları BII referansında bulabilirsiniz. Örneğin,GET_THING
BII'deAction ID
değeriactions.intent.GET_THING
olarak listelenir.Uygulama hedefi: Kullanıcı isteğini karşılamak için işlemin uygulamanızda başlatıldığı hedef.
capability
içine yerleştirilmişintent
öğelerini kullanarak uygulama hedeflerini tanımlayın.Parametre eşlemeleri: Her
intent
, amacınextra
verisi olarak iletilecek parametreler içerebilir. Örneğin, her bir Uygulama İşlemi BII'de, kullanıcıların BII'yi tetikleyen sorgularda sıklıkla sağladığı bilgileri temsil eden alanlar bulunur.
Aşağıdaki örnekte, kullanıcıların fitness uygulamasında antrenmana başlamak için Asistan ile sesli komutları kullanmalarına olanak tanıyan actions.intent.START_EXERCISE
adlı BII için shortcuts.xml
dilinde 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, START_EXERCISE
BII'yi belirtir. Bir kullanıcı Asistan'a "Ok Google, ExampleApp'te çalıştırma 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ımlamaktadır:
android:targetPackage
, bu amaç için hedef uygulama paketini ayarlar.android:targetClass
alanı, hedef etkinliği belirtir:com.example.sampleApp.ExerciseActivity
.parameter
amacı,exercise.name
BII parametresini desteklediğini ve kullanıcıdan toplanan parametre değerininintent
içinde ekstra veri olarak nasıl iletileceğini açıklar.
Kısayolları bir özellikle ilişkilendirme
Bir özelliği tanımladıktan sonra, statik veya dinamik kısayolları ilişkilendirerek işlevselliğini genişletebilirsiniz. Kısayolların bir capability
öğesine bağlanma şekli, uygulanmakta olan özelliğe ve kullanıcının isteğindeki gerçek kelimelere bağlıdır. Örneğin, bir kullanıcı fitness takip uygulamanızda Asistan'a "Ok Google, ExampleApp'te koşu başlat" diyerek koşuya başladığında. Asistan, kısayol kullanarak exercise.name
parametresi için "run" geçerli bir egzersiz varlığını tanımlayan capability
örneğini başlatabilir.
Kısayolları Uygulama İşlemleri ile ilişkilendirme hakkında daha fazla bilgi için Uygulama İşlemlerine genel bakış konusuna bakın.