Uygulama İşlemleri için yerleşik amaçlar

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.

Şekil 1. Asistan'a sesli sorgu göndererek START_EXERCISE BII'yi çağırın.
Şekil 2. START_EXERCISE görevine başlamak için uygulamayı belirli bir ekranda başlatın.
Şekil 3. Sorguya yanıt olarak bir widget görüntüleme.

​

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:

  1. capability öğesini, seçilen BII ile tanımlayın.
  2. Eklemek istediğiniz her BII alanı için iç içe yerleştirilmiş parameter öğeleri ekleyin.
    1. targetClass veya targetPackage kullanıyorsanız seçtiğiniz bir adı kullanarak bunları Android intent extras ile eşleyin.
    2. 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.