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

Yerleşik amaçlar (BII'lar), uygulamanızın istek karşılama özelliklerini Google'a göstermesine olanak tanır. shortcuts.xml dosyanızda özellikleri beyan ederek ve amaç parametrelerini istek karşılama ile eşleyerek Google Asistan'ın bir sorguya yanıt olarak uygulamanızı belirli bir ekranda başlatmasına olanak tanırsı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 genellikle gerçekleştirmek istedikleri bir dizi yaygın görevi temsil eder. Mevcut BII'ların, parametrelerin ve test için kullanılabilecek örnek sorguların tam listesini yerleşik amaç referansında bulabilirsiniz.

Birçok BII'nın belirli dağıtım gereksinimleri ve önerileri vardır. Bu gereksinimler 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örevini başlatmak için uygulamayı belirli bir ekranda başlatın.
Şekil 3. Sorguya yanıt olarak bir widget görüntüleyin.

BiI'ları uygulama ve amaç parametrelerini ele alma

Uygulama İşlemleri için shortcuts.xml dosyanızda özellikleri beyan eder ve BII parametrelerini işlersiniz. Bir BII'yi uygulamak ve parametrelerini işlemek için şu adımları izleyin:

  1. Seçilen BII ile capability 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ı extras Android niyetiyle 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. Daha sonra, değerini uygulamanızda kullanabilirsiniz. Uygulamanızın BII parametrelerini işlemesi gerekmez. Bununla birlikte, yerleşik amaç referansında "Önerilir" olarak işaretlenmiş veri alanlarını işlemeyi deneyin.

Her biri kendi önerilen parametre grubuna sahip olan birden fazla amaç yerine getirme tanımlayabilirsiniz. Google, kullanıcının sorgusundan tanımladığı ve amaçta bildirilen özelliklere 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. Kullanıcı sorgularını belirli bir egzersiz adı olmadan işlemek istiyorsanız bunu yapabilirsiniz. Örneğin, "Örnek Uygulamadan egzersizi izlemeye başlamasını isteyin"

Parametreler kullanıcının sorgusuna dahil edilmezse aşağıdaki snippet, gerekli parametre içermeyen bir istek karşılamanın yedeğine sahiptir:

<?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, Örnek Restoran'ın mobil uygulamasından pizza siparişi vermeye yönelik kullanıcı sorguları her zaman konum bilgisi içermez. Asistan, kullanıcıya daha iyi hizmet vermek 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, kullanıcının gerçek dünyadaki durumunu değiştiren bir işlemi (örneğin, para aktarma, sipariş verme veya mesaj gönderme) önce kullanıcıyla onaylamadan doğrudan gerçekleştirmesini istemezsiniz.

Netleştirme

<url-parameter> veya intent ekstraları aracılığıyla uygulamanıza 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. Böylece kullanıcı, içeriği netleştirebilir ve doğru öğeyi seçebilir.

Örneğin, bir kullanıcının sorgusu BII ORDER_MENU_ITEM için "Örnek Restorandan Sipariş" şeklindeyse 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 tarafından geliştirme ve test için desteklenen yerel ayarlar, yerleşik amaç referansında listelenmiştir. Bazı BII'lar, geliştirici testi ve Asistan'dan kullanıcı tetiklemek için farklı yerel ayar desteğine sahiptir.