Uygulama İşlemleri, kullanıcıların şunları sorarak Android uygulamanızda işlevi başlatmalarına olanak tanır: Google Asistan'ın önerdiği Android kısayollarını kullanarak. Bu Android uygulamanızı Uygulama İşlemleri ile genişletmenin birincil adımlarıdır:
- Tetiklenecek uygulama içi işlevi ve eşleştirmesini tanımlama yerleşik amaç (BII) özelliklerini kullanabilirsiniz.
- BII için sipariş karşılama ayrıntılarını girin.
- Uygulama İşleminizin kısayollarını Asistan'a aktarın.
- Uygulama İşlemlerinizi bir test cihazında önizleyin.
- Uygulamanızın test sürümünü oluşturun.
- Uygulama İşlemleri incelemesi ve dağıtımı isteyin.
İsteğe bağlı olarak, Asistan'a sağlayacağı dinamik kısayollar tanımlayabilirsiniz. bu önerileri kullanıcılarınıza önerin. Örnek bir uygulama kullanarak Uygulama İşlemi oluşturun: Uygulama İşlemleri codelab'ini inceleyin.
Gereksinimler
Uygulama İşlemleri geliştirmeye başlamadan önce hem sizin hem de uygulamanızın aşağıdaki şartları yerine getirmeniz gerekir:
- Google Play Console.
- Uygulama İşlemleri şu nedenle Google Play Store'da yayınlanmalıdır: yalnızca burada yayınlanan uygulamalarla kullanılabilir. Ayrıca, uygulamanızın Uygulama İşlemleri desteklenmediğinden, bir iş profilinde kullanılması amaçlanmamıştır Managed Google Play tarafından:
- Uygulama İşlemlerinizi test etmek için fiziksel veya sanal bir cihaza ihtiyacınız vardır.
- Android Studio'nun en son sürümüne ihtiyacınız var.
- Android'de oturum açmak için aynı Google Hesabı'nı kullanmanız gerekir. Studio, test cihazınızdaki Google uygulaması ve Google Play Console.
- Test cihazınızda Asistan'ı kurmalı ve aşağıdaki adımları uygulayarak test etmelisiniz: dokun ve Ana sayfa düğmesini basılı tutun.
Yerleşik amaçları uygulama işlevselliğiyle eşleştirin
Android uygulamanızda kullanıcıların isteyebilecekleri işlevleri tanımlama bir sonraki aşamaya geçmeli ve uygun BBI'leri bulmak için yerleşik amaç referansı örneklere göz atın. BII'ler, istedikleri görevler için kullanıcı sorguları modeli Bu nedenle, temel işlev ve kullanıcı deneyimiyle eşleşen BII'leri arayın. takip edebilirsiniz.
Hemen hemen her Android uygulamasının kullanabileceği yaygın BBI'ler vardır. Örneğin,
actions.intent.GET_THING
ile uygulama içi aramanızı Asistan'a gönderin
BII veya kullanıcıların belirli uygulama özelliklerini sesleriyle başlatmalarına izin verme
actions.intent.OPEN_APP_FEATURE
BII'yi uygulama.
Sektör veya kategoriye özel kullanım alanlarına olanak tanıyan BBI'ler de vardır. Örneğin,
Örneğin, bir yemek siparişi uygulaması actions.intent.ORDER_MENU_ITEM
BBI.
Mükemmel bir kullanıcı deneyimi sağlamak ve olası onay gecikmelerini önlemek için uyguladığınız her BII'nin uygulama içi işlevinizle alakalı olduğundan emin olun.
Uygulama İşlemleri, Asistan uygulamasından Android intent'lerini başlatarak çalışır.
kullanıcıları doğrudan uygulamanızdaki belirli bir içeriğe
yönlendirmek için kullanır. Amaçları şu şekilde tanımlayabilirsiniz:
bir etkinliği açık bir şekilde başlatmak içintargetClass
ve
targetPackage
alanları için geçerlidir. Uygulamanızda zaten Android derin bağlantısı kullanılıyorsa
derin bağlantı kullanma niyetini yapılandırabilirsiniz.
istek karşılamayı da kapsar. Daha fazla bilgi için Etkinliğinizi ayrıntılı olarak test etme
bağlantılar bölümüne bakın.
Yerleşik amaçlar için karşılama ayrıntıları sağlayın
Bir Uygulama İşlemi oluşturmanın büyük bir kısmı,
Android uygulamanızın shortcuts.xml
kaynak dosyası
seçtiğiniz BII'yi ve buna karşılık gelen karşılamayı belirtin. BII,
bir görev için kullanıcı sorgusuna bağlı olarak, yerine getirme amacı da Asistan'a
görevin nasıl gerçekleştirileceğine dair bilgi sağlar.
shortcuts.xml
dosyanızda, BBI'lar <capability>
olarak gösterilir.
öğelerinde bulunur ve her karşılama bir <intent>
öğesi olarak temsil edilir:
<shortcuts>
<capability android:name="actions.intent.ORDER_MENU_ITEM">
<intent
android:action="android.intent.action.VIEW"
android:targetPackage="com.example.app"
android:targetClass="com.example.app.browse">
<parameter
android:name="menuItem.name"
android:key="query">
</parameter>
</intent>
</capability>
Çoğu BBI'de, intent parametrelerini kullanıcı sorgusundan çıkarırsınız.
schema.org varlıklarına göre yapılır. Uygulamanız bu BII'yi kullanır
parametreleri kullanabilirsiniz. Örneğin,
önce
kod, menuItem.name
BII parametresini query
Android intent
ile eşleştirir
parametresinden sonra bir değer girin.
İşlemleri derin bağlantılar kullanarak gerçekleştiriyorsanız urlTemplate
alanını kullanırsınız.
Asistan'ın oluşturduğu derin bağlantı URL'sini tanımlamak için:
<shortcuts>
<capability android:name="actions.intent.ORDER_MENU_ITEM">
<intent android:action="android.intent.action.VIEW">
<url-template android:value="myfoodapp://browse{?query}" />
<parameter android:name="menuItem.name"
android:key="query"
android:mimeType="text/*">
</parameter>
</intent>
</capability>
</shortcuts>
.
shortcuts.xml
dosyasına Uygulama İşlemleri eklemeyle ilgili önemli ayrıntılar için
shortcuts.xml
oluşturma bölümüne bakın. Söz konusu sayfa ayrıca
uygulamanızın beklediği parametre değerlerinin nasıl belirtileceğini açıklar.
GET_THING yerleşik amacını uygulayın
Uygulamanızda arama işlevi varsa
actions.intent.GET_THING
BII'sini kullanabilirsiniz. Asistan daha sonra yönlendirme yapabilir
Kullanıcılar, uygulama içi sonuçlar için uygulamanızın arama işlevine sorgu gönderir
Örneğin, "Ok Google, Örnek Uygulama'da Örnek Şey ara" gibi bir ifade kullanabilirsiniz.
shortcuts.xml
dosyanızda şunun için bir <capability>
uygulayın:
actions.intent.GET_THING
BII'yi
başka herhangi bir BII'yi uygulayabilirsiniz. Şunlar için birden fazla sipariş karşılama kullanabilirsiniz:
Kullanıcı tarafından yapılan sipariş karşılama işlemlerinden en az birini sağladığınız sürece GET_THING
uygulamanızın arama işlevine sorgu gönderir.
Aşağıda, actions.intent.GET_THING
BII'sinin eklendiği
shortcuts.xml
:
<capability android:name="actions.intent.GET_THING">
<intent
android:targetPackage="com.example.myapp"
android:targetClass="com.example.myapp.MySearchActivity">
<parameter android:name="thing.name" android:key="query" />
</intent>
</capability>
Activity
aramanızda,
intent
ve uygulamanızın arama işlevine iletin. Önceki kodda,
query
tuşu olarak iletilen arama sorgusu, "thing.name"
ile eşlenir.
BII parametresidir. Ardından, sorguyla bir arama yapın ve sonuçları şurada görüntüleyin:
kullanıcı arayüzü.
İsteğe bağlı: Uygulama İşleminizin kısayollarını Asistan'a aktarma
İşleminiz için bir özellik tanımlamanızın ardından, kullanıcılar "Ok Google, Örnek Uygulama'da pizza sipariş et" gibi bir şey söyleyerek işlemi tamamlayın. Asistan, uygun olduğu yerlerde kullanıcılara işlemleriniz için Android kısayolları önerebilir Böylece, hareketlerinizi keşfedip tekrar oynatabilirler. Asistan hem dinamik hem de statik kısayollar önerebilir.
Dinamik kısayolları Asistan'a aktarmak için Google Kısayollar Entegrasyonu'nu kullanın kitaplığını açar. Bu Jetpack kitaplığı, Asistan'ın kısayollarınızı almasını ve uygun zamanda önermenize yardımcı olur.
Daha fazla bilgi için Dinamik kısayolları Asistan'a aktarma başlıklı makaleyi inceleyin.
Uygulama İşlemlerinizi önizleyin
Geliştirme ve test sırasında Google Asistan eklentisinin yardımıyla Android Studio'da bunu test edebilirsiniz Uygulama İşlemleri, uygulamanız için çalışır. Eklenti, uygulama işlemlerinizin önizlemesini oluşturur inceleyebilirsiniz. Test aracını kullanarak BII'leri girişle sağlayarak fiziksel test cihazında veya emülatörde karşılama belirli parametreler olabilir.
Uygulama İşlemlerinizi önizlerken aşağıdaki olanak tanır. Bu işlev yalnızca Uygulama İşlemleri için BII referansı. Sesi kullan yalnızca gösterim için değil, düzenli test için tetiklenmelidir.
Google Play için geliştirici araçlarını kullanarak uygulamanızı taslak modunda test etme Play Console'a göz atın. Google Play Console'u kullanarak taslak dağıtma hakkında daha fazla bilgi hakkında daha fazla bilgi edinmek için Bir sürüm ekleyebilirsiniz.
Test sürümü oluşturma
Uygulama İşlemlerinizi ek test kullanıcıları ile test etmeye hazır olduğunuzda Uygulamanızın dahili veya kapalı test sürümünü oluşturun. Varsayılan olarak, dahili ve Kapalı sürüm test kullanıcıları, önceden eklenmiş olan Uygulama İşlemleri'ne incelenip onaylanmış olur.
Onaylanmamış işlemler de dahil olmak üzere tüm Uygulama İşlemlerine test erişimi vermek için: test kullanıcılarınıza Uygulama İşlemleri Geliştirme Programı Google Grubu. Bu grubun üyeleri grubu, kapalı ve açık konumlardaki tüm Uygulama İşlemlerine erişebilir dahili test sürümlerini kullanarak önizleme oluşturmaya gerek kalmadan uygulama işlemleri test aracı'ndan yararlanabilirsiniz. Gruba katıldıktan sonra bu süreç üç saati bulabilir. ekleyebilirsiniz.
Uygulama İşlemleri incelemesi ve dağıtımı isteyin
Uygulama İşlemleri, yayınlanan uygulamalarınızın veya açık testinizin kullanıcıları tarafından kullanılamaz
ve onaylanana kadar yayınlar. Uygulama İşlemleri incelemesi
Google Play'de Android uygulamanızın inceleme ve dağıtım durumunu etkiler. Hatta
uygulama gönderiminiz onaylanıp Play Store'da yayınlandığında,
shortcuts.xml
, Google tarafından inceleniyor olabilir. Uygulama İşlemleri,
bu inceleme de onaylanana kadar geçen süreyi ifade eder.
Uygulamanızı dağıttığınızda Uygulama İşlemleri etkin kalır. Ancak, Yeniden dağıtılan sürümler Google tarafından incelenir. Yeni sürüm düzgün şekilde çalışmıyorsa veya politika ihlalleri içeriyorsa Google, uygulamanız için Uygulama İşlemleri'ni devre dışı bırakın.
Uygulama İşlemlerinizi incelemeye göndermek için aşağıdakileri yapın:
Google Play Console'da Uygulama İşlemleri hizmet şartlarını kabul edin (Gelişmiş ayarlar > Uygulama İşlemleri):
shortcuts.xml
içeren uygulamanızı şuraya yükleyin: Google Play Console'u kullanabilirsiniz.Uygulamanızı Play Console'a yükledikten sonra Google, e-posta gönderebilirsiniz. en son İşlemlerin incelenmesi. Asistan Geliştirici Destek Ekibi ile de iletişime geçebilirsiniz Uygulama İşlemleri inceleme durumunuzla ilgili sorularınız varsa. İlgili kişi formundan uygulama paketi kimliğinizi girin ve Uygulama İşlemi incelemesi öğesini seçin Size nasıl yardımcı olabiliriz? seçim kutusunu işaretleyin.
İsteğe bağlı: Etkinliğinizin derin bağlantılarını test etme
Uygulama İşlemi kullanarak bir Activity
başlatmak üzere derin bağlantı kullanmak için Activity
derin bağlantı URL'leriyle oluşturulmalı ve
Android uygulama manifest'inde yer alıyor.
Etkinliklerinizin erişilebilir olduğunu ve
Derin bağlantıları kullanan Uygulama İşlemleri için aşağıdaki adb
komutunu çalıştırın:
$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"
Örnek:
$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"
Etkinliğiniz adb
komutuyla doğru şekilde başlatılmazsa
aşağıdakileri kontrol edin:
- Uygulama manifest dosyanızda, etkinlik
android:exported=true
olduğundan şunları yapabilir: Google Asistan'ın amaçları kullanılarak başlatılabilir. - Uygulama Bağlantıları URL'lerini kullanıyorsanız Android App Links'i kullanma.
Uygulama İşlemleri politikaları
Uygulama İşlemleri, belirli politikalara uyması gerekir. istenen deneyimi sağlamalarını tetikleyecekler. Şu tarihten önce bu politikaları inceleyin: en iyi kullanıcı deneyimini sunmak ve Google Play'den kaçınmak için uygulamalarınızı Mağaza incelemesinde yaşanan gecikmeler veya retler
Kullanıcıları, kullanıcı tarafından oluşturulan içeriğe yönlendirme
Uygulama İşlemi yerleşik amaçları (BII'ler) ve/veya parametreleri, kullanıcıları yalnızca ilgili ve kullanıcının niyetindeki eylemdir. Buna uygulama içi içerik, dilimlerde veya widget'larda gösterilen bilgilerin, kullanıcı tarafından amaçlanıyordu.
Örneğin,
ORDER_MENU_ITEM
BII uygulamaları, Belirtilen menü seçeneği veya mutfak türü için bir sipariş başlatır. TekOPEN_APP_FEATURE
BII'nizin kullanıcıları yönlendirdiği durumlar bu politikanın istisnasıdır. dokunun.Kullanıcıları alakalı web içeriğine yönlendirme
Kullanıcılar bir web sayfası içeriğine yönlendiriliyorsa, web sitesi markaya ait olan ve kullanıcının amaçladığı eylemdir.
Örneğin, bir dönüşüm başlatan veya ait olmayan,
GET_RESERVATION
BII'nizigoogle.com/travel
hesabına Uygulamanızınexampledomain.com
markası politika ihlalidir. Bir başka örnek deGET_CALL_HISTORY
BII'nizi tetikleyen kullanıcılarınexampledomain.com/payment
kullanıyor ve satın alma işlemi yapmalarını gerektiriyor.Alakalı Uygulama İşlemleri BBI'lerini uygulayın
Uygulanan BBI'ler, uygulamanın içeriğiyle doğrudan alakalı olmalıdır. işlevi görür.
Örneğin, uygulamanız İletişim Play Store kategorisindeyse
ORDER_MENU_ITEM
BII'yi kullanmayın. Yiyecek ve İçecek kategorisindeki uygulamalar için önerilenler.Alakalı özel amaçları uygulama
Özel amaçlar için tanımlanmış sorgular uygulamanın içeriğiyle alakalıdır ve işlevi görür. Bunun olası bir ihlaline örnek politikası
custom.action.intent.GET_RECIPE
"Burrito tariflerini göster" sorgu kalıbı bir uygulama için Ulaşım Play Store kategorisi.