Yerleşik amaçlar (BII'ler), uygulamanızın istek karşılama özelliklerini Google'a ifade etmesini sağlar. Kısayollar.xml dosyanızda özellikleri tanımlayarak ve intent parametrelerini istek karşılama ile eşleyerek Google Asistan'ın bir sorguya yanıt olarak uygulamanızı belirli bir ekranda başlatmasını sağlarsınız. Böylece kullanıcı bir görevi tamamlayabilir.
Yerleşik amaçlar, uygulama kategorilerine göre gruplandırılır. Her kategori, kullanıcıların uygulamalarında sıklıkla gerçekleştirmek istedikleri bir dizi genel görevi temsil eder. Kullanılabilir BBI'lerin, parametrelerinin ve test için kullanılabilecek örnek sorguların tam listesini yerleşik amaç referansında bulabilirsiniz.
Birçok BII'nin belirli dağıtım gereksinimleri ve önerileri vardır. Bu şartlar ve öneriler, uygulamanızın kullanıcılarınıza mümkün olan en iyi deneyimi sunmasına yardımcı olur.
BBI'leri uygulama ve intent parametrelerini yönetme
Uygulama İşlemleri için Kısayollar.xml dosyanızda özellikleri açıklar ve BII parametrelerini işlersiniz. BII uygulamak ve parametrelerini işlemek için aşağıdaki adımları izleyin:
capability
öğesini, seçilen BII ile tanımlayın.- Eklemek istediğiniz her BII alanı için iç içe yerleştirilmiş
parameter
öğeleri ekleyin.targetClass
veyatargetPackage
kullanıyorsanız seçtiğiniz bir adı kullanarak bunları Android intentextras
ile eşleyin.- Derin bağlantı URL'si kullanıyorsanız URL şablonunun sorgu dizesinde adlandırılmış parametreleri kullanın.
Bir BII parametresini işlemek için BII parametresini, capability
içindeki açık bir Android amacının karşılık gelen parametresiyle eşleyin.
Ardından, değerini uygulamanızda kullanabilirsiniz. Uygulamanızın, BBI parametrelerini işlemesi gerekmez. Ancak, yerleşik amaç referansında "Önerilen" olarak işaretlenen veri alanlarını işlemeye çalışın.
Her biri kendi önerilen parametre grubuna sahip birden fazla amaç yerine getirme tanımlayabilirsiniz. Google, kullanıcının sorgusunda tanımladığı özellik parametrelerine ve bir amaçta belirtilenlere göre uygun istek karşılamayı seçer.
Örneğin actions.intent.START_EXERCISE
amacı, uygulamanızın exercise.name
BII parametresini işlemesini önerir ancak BII'yi uygulamanıza parametre olmadan uygulayabilirsiniz.
Belirli bir egzersiz adı olmadan kullanıcı sorgularını ele almak istiyorsanız bunu yapabilirsiniz. Örneğin, "Örnek Uygulamaya Egzersizi izlemeye başlamasını isteyin."
Parametreler kullanıcının sorgusuna dahil edilmezse aşağıdaki snippet'te, zorunlu parametre olmayan bir istek karşılama yedeği bulunur:
<?xml version="1.0" encoding="utf-8"?>
<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:targetClass="com.example.myapplication.Activity1"
android:targetPackage="com.example.myapplication">
<parameter
android:name="exercise.name"
android:key="exerciseType"
android:required="true"
/>
</intent>
<intent
android:action="android.intent.action.VIEW"
android:targetClass="com.example.myapplication.Activity2">
</intent>
</capability>
</shortcuts>
Google Asistan, uygulamanıza parametre değerlerini döndürürken kullanıcıya en alakalı bilgileri sağlamak için elinden geleni yapar. Örneğin, Example Restaurant'ın mobil uygulamasından pizza siparişi vermek için yapılan kullanıcı sorguları her zaman bir konum içermez. Asistan, kullanıcıya daha iyi hizmet sunmak için söz konusu uygulamaya en yakın Örnek Restoran'ın enlem ve boylam değerlerini sağlayabilir.
Ek bir şart olarak, uygulamanızın, önce kullanıcıyla ilgili işlemi onaylamadan, kullanıcının gerçek dünyadaki durumunu değiştiren bir işlem (örneğin para aktarma, sipariş verme veya mesaj gönderme) gerçekleştirmesini doğrudan istemezsiniz.
Netleştirme
Uygulamanıza <url-parameter>
veya intent ekstraları aracılığıyla iletilen bağımsız değişkenler, kullanıcıya göstermek istediğiniz öğeyi benzersiz bir şekilde tanımlamayabilir. Bu durumda, bağımsız değişken değerini arama bağımsız değişkeni olarak kullanın ve kullanıcıyı uygulamanın arama sayfasına yönlendirin.
Örneğin, bir kullanıcının sorgusu BBI ORDER_MENU_ITEM
için "Örnek Restorandan Sipariş" ise kullanıcıya adları "Example Restaurant"
terimiyle eşleşen restoranların listesini sunabilirsiniz.
Dil ve yerel ayar desteği
Her bir Uygulama İşlemi BII'si tarafından geliştirme ve test için desteklenen yerel ayarlar yerleşik amaç referansında listelenmiştir. Bazı BII'ler, geliştirici testi ve Asistan'ın kullanıcı tetiklemesi için farklı yerel ayar desteğine sahiptir.