Tworzenie działań w aplikacji

Akcje w aplikacji umożliwiają użytkownikom uruchamianie funkcji w aplikacji na Androida za pomocą prośby Asystenta Google lub skrótów na Androidzie zaproponowanych przez Asystenta. Te to główne etapy rozszerzenia aplikacji na Androida za pomocą działań w aplikacji:

1. Zidentyfikuj funkcję w aplikacji, która ma zostać uruchomiona, i jej dopasowanie intencje wbudowane (BII).
2. Podaj szczegóły realizacji zamówienia BII.
3. Przekazuj do Asystenta skróty akcji w aplikacji.
4. Wyświetl podgląd akcji w aplikacji na urządzeniu testowym.
5. Utwórz wersję testową aplikacji.
6. Poproś o sprawdzenie i wdrożenie akcji w aplikacji.

Opcjonalnie możesz zdefiniować dynamiczne skróty, które będą dostępne dla Asystenta, zasugerować je użytkownikom. Utwórz działanie w aplikacji za pomocą przykładowej aplikacji wykonaj ćwiczenie z programowania dotyczące działań w aplikacji.

Uwaga: ze względu na ograniczenia prawne aplikacje uczestniczące w programie Designed dla całej rodziny (DFF) nie mogą zawierać akcji w aplikacji. Jeśli prześlesz Działanie w aplikacji do sprawdzenia w przypadku aplikacji uwzględnionej w programie Dla całej rodziny, nie mogą zostać zatwierdzone.

Wymagania

Zanim zaczniesz tworzyć działania w aplikacji, upewnij się, że zarówno Ty, jak i Twoja aplikacja spełniacie następujące wymagania:

• Musisz mieć konto Google z dostępem do Konsola Google Play.
• Aplikacja musi zostać opublikowana w Sklepie Google Play, ponieważ akcje w aplikacji dostępny tylko w przypadku opublikowanych tam aplikacji. Upewnij się też, że aplikacja jest nieprzeznaczonych do użytku w profilu służbowym, ponieważ akcje w aplikacji nie są obsługiwane, w zarządzanym Sklepie Google Play.
• Aby testować działania w aplikacji, musisz mieć urządzenie fizyczne lub wirtualne.
• Musisz mieć najnowszą wersję Android Studio.
• Aby zalogować się na urządzeniu z Androidem, musisz użyć tego samego konta Google. Studio, aplikację Google na urządzeniu testowym i Konsolę Google Play.
• Skonfiguruj Asystenta na urządzeniu testowym i przetestuj go, wykonując dotknij & i przytrzymaj przycisk ekranu głównego.

Dopasuj intencje wbudowane do funkcji aplikacji

Określ, które funkcje aplikacji na Androida mogą być przydatne dla użytkowników aby przejść do następnego utworu, wymawiając go na głos i sprawdzić dokumentacja dotycząca wbudowanych intencji, która pozwala znaleźć odpowiednie wskaźniki analityki biznesowej. do swoich zastosowań. BII – zapytania użytkowników dotyczące działań, które chcą Dlatego należy szukać identyfikatorów BII, które pasują do najważniejszych funkcji i użytkowników w Twojej aplikacji.

Istnieją typowe interfejsy BII, z których może korzystać prawie każda aplikacja na Androida, np. rozszerzenie wyszukiwanie w aplikacji do Asystenta za pomocą actions.intent.GET_THING BII lub zezwalanie użytkownikom na uruchamianie określonych funkcji za pomocą głosu, wdrożenie actions.intent.OPEN_APP_FEATURE BII.

Ważne: zgodnie z wymaganiami dotyczącymi wdrożenia akcji w aplikacji aplikacje, które w funkcji wyszukiwania musi zaimplementować actions.intent.GET_THING BII, tak aby użytkownicy mogli wyszukiwać treści w aplikacji za pomocą często używane polecenia głosowe, takie jak OK Google, wyszukaj buty do biegania na Przykładowa aplikacja”.

Istnieją też wskaźniki analityki biznesowej, które umożliwiają zastosowanie w branży lub w zależności od kategorii. Dla: na przykład aplikacja do zamawiania jedzenia może korzystać z funkcji actions.intent.ORDER_MENU_ITEM BII.

Uwaga: jeśli nie ma kodu BII dla funkcji aplikacji, możesz użyć niestandardową intencję do rozszerzenia aplikacji za pomocą działań w aplikacji.

Aby zadbać o wygodę użytkowników i uniknąć ewentualnych opóźnień w zatwierdzaniu, Upewnij się, że każdy wdrożony BII ma związek z funkcjami aplikacji.

Akcje w aplikacji uruchamiają intencje Androida w aplikacji Asystent do konkretnych treści w aplikacji. Możesz zdefiniować intencje uruchom działanie wyraźnie, określając targetClass i targetPackage pól. Jeśli Twoja aplikacja ma już wdrożony precyzyjny link na Androida adresów URL, możesz skonfigurować intencję użycia precyzyjnego linku i realizacji. Więcej informacji znajdziesz w artykule Przeprowadzanie szczegółowych testów aktywności linki.

Podaj szczegóły realizacji dla intencji wbudowanych

W większości przypadków podczas tworzenia akcji w aplikacji deklaruje się odpowiednią możliwości shortcuts.xml – plik zasobów aplikacji na Androida, w którym określ wybrany BII i odpowiadającą mu realizację. A BII modeluje użytkownik może wysłać zapytanie do użytkownika, a intencja realizacji dostarcza Asystentowi o tym, jak je wykonać.

W pliku shortcuts.xml identyfikatory BII są przedstawiane jako <capability> i każda realizacja jest reprezentowana jako element <intent>:

<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>

Uwaga: na urządzeniu z Androidem wymagana jest biblioteka Jetpack androidx.core:core:1.6.0 (lub nowsza). projektu, aby uniknąć błędów kompilacji podczas definiowania możliwości akcji w shortcuts.xml. Więcej informacji znajdziesz w artykule Pierwsze kroki z Androidem Jetpack.

W przypadku większości BII parametry intencji trzeba wyodrębnić z zapytania użytkownika. na podstawie encji schema.org. Aplikacja używa tych BII parametrów, aby kierować użytkowników do wybranej funkcji. Na przykład parametr poprzedzający kod mapuje parametr menuItem.name BII na query intent Androida .

Jeśli wykonujesz działania za pomocą precyzyjnych linków, użyj pola urlTemplate aby zdefiniować precyzyjny link generowany przez Asystenta:

<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>

. Wskazówka: gdy aplikacja dostarcza wiele intencji do zrealizowania w przypadku jednej BII, Asystent próbuje rozwiązać problemy w kolejności, w jakiej występują capability.

Ważne informacje o dodawaniu akcji w aplikacji do pliku shortcuts.xml znajdziesz zapoznaj się z sekcją Tworzenie elementu shortcuts.xml. Ta strona też zawiera opis sposobu określania wartości parametrów spodziewanych przez aplikację.

Wdróż wbudowaną intencję GET_THING

Jeśli aplikacja ma funkcję wyszukiwania, musisz zaimplementować funkcję actions.intent.GET_THING BII dla tej funkcji. Asystent może wtedy przekazać dalej do funkcji wyszukiwania wyników w aplikacji, gdy użytkownicy wpisują w niej zapytanie np. „OK Google, wyszukaj przykładową rzecz w aplikacji Przykładowa aplikacja”.

W pliku shortcuts.xml zaimplementuj <capability> dla actions.intent.GET_THING BII wdrożyć dowolne inne BII. Możesz używać wielu realizacji dla GET_THING, o ile podasz co najmniej jedną realizację, która pomija użytkownika do funkcji wyszukiwania w aplikacji.

Oto przykład dodania funkcji actions.intent.GET_THING BII w 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>

W wyszukiwaniu Activity wyodrębnij wyszukiwane hasło z dodatkowych danych funkcji intent i przekazać go do funkcji wyszukiwania w aplikacji. W poprzednim kodzie para klucz-wartość wyszukiwane hasło przekazywane jako klucz query, mapuje na "thing.name" BII. Następnie wyszukaj to hasło i wyświetl wyniki w do interfejsu.

Opcjonalnie: przesyłaj do Asystenta skróty do akcji w aplikacji

Gdy zdefiniujesz możliwość działania, użytkownicy będą mogli uruchomić działanie, mówiąc na przykład: „OK Google, zamów pizzę w aplikacji Przykładowa aplikacja”. Asystent może proponować użytkownikom skróty na Androidzie związane z Twoimi działaniami co pozwoli im odkrywać i ponownie odtworzyć Twoje działania. Asystent może sugerować zarówno dynamiczne, jak i statyczne skróty.

Aby przekazać skróty dynamiczne do Asystenta, użyj integracji skrótów Google bibliotece. Dzięki tej bibliotece Jetpack Asystent może korzystać ze skrótów są proponowane użytkownikom w odpowiednim czasie.

Więcej informacji znajdziesz w artykule Przekazywanie dynamicznych skrótów do Asystenta.

Podgląd akcji w aplikacji

W trakcie programowania i testowania wtyczkę Asystenta Google w Android Studio, aby to przetestować Akcje w aplikacji działają w Twojej aplikacji. Wtyczka tworzy podgląd akcji w aplikacji w Asystencie na Twoim koncie Google. Za pomocą tego narzędzia możesz sprawdzić realizacji na fizycznym urządzeniu testowym lub w emulatorze przez udostępnienie funkcji BII z danymi wejściowymi. których oczekujesz od użytkowników.

Uwaga: do działań w aplikacji możesz też dodawać kolejnych testerów nawet jeśli nie należą do tego samego konta w Konsoli Play. Do więcej informacji, patrz Dodaj kolejnych testerów

Wyświetlając podgląd akcji w aplikacji, możesz uruchamiać zapytania głosowe na urządzenia. Ta funkcja jest dostępna tylko w przypadku zapytań wymienionych w Dokumentacja BII dla działań w aplikacji. Użyj głosu wyzwalanie tylko w celach demonstracyjnych, a nie do zwykłych testów.

Uwaga: narzędzie do testowania akcji w aplikacji obsługuje tylko testowanie BII w pl-PL, chyba że w sekcji odpowiednie referencje do intencji wbudowanej.

Przetestuj aplikację w wersji roboczej za pomocą narzędzi dla programistów w Google Play konsoli. Więcej informacji o wdrażaniu wersji roboczej za pomocą Konsoli Google Play Więcej informacji znajdziesz w artykule Przygotowanie i uruchomienie wersji.

Tworzenie wersji testowej

Gdy zechcesz przetestować akcje w aplikacji z pomocą dodatkowych testerów, utworzyć wewnętrzne lub zamknięte wersje testowe aplikacji. Domyślnie wewnętrzne i testerzy wersji zamkniętych mają dostęp do działań w aplikacji, które zostały już sprawdzonych i zatwierdzonych.

Aby przyznać dostęp do testów do wszystkich akcji w aplikacji, w tym do niezatwierdzonych: poinstruuj testerów, aby dołączyli do Program rozwoju aplikacji. Członkowie ma dostęp do wszystkich akcji w aplikacji wersji do testów wewnętrznych bez konieczności tworzenia podglądów w narzędziu narzędzie do testowania działań w aplikacji. Może minąć do 3 godzin od dołączenia do grupy z którego można korzystać.

Uwaga: działania w aplikacji na ścieżce testu otwartego nie są dostępne dla użytkowników do czasu sprawdzenia i zatwierdzenia działań. Więcej informacji: w następnej sekcji.

Poproś o sprawdzenie i wdrożenie akcji w aplikacji

Akcje w aplikacji nie są dostępne dla użytkowników Twoich opublikowanych aplikacji ani testów otwartych wersji, dopóki nie zostaną sprawdzone i zatwierdzone. Sprawdzenie akcji w aplikacji: wpływają na stan sprawdzania i wdrażania aplikacji na Androida w Google Play. Nawet jeśli przesłana aplikacja zostanie zatwierdzona i opublikowana w Sklepie Play, shortcuts.xml może być w trakcie sprawdzania przez Google. Akcje w aplikacji nie działają w przypadku: użytkowników do momentu zatwierdzenia takiej weryfikacji.

Po wdrożeniu aplikacji akcje w aplikacji pozostają aktywne. Pamiętaj jednak: ponownie wdrożone wersje podlegają sprawdzeniu przez Google. Jeśli nowa wersja to nieprawidłowo lub narusza zasady, Google zastrzega sobie prawo do dezaktywuj Akcje w swojej aplikacji.

Aby przesłać działania w aplikacji do sprawdzenia:

1. Zaakceptuj warunki korzystania z akcji w aplikacji w Konsoli Google Play (Ustawienia zaawansowane > Działania w aplikacji):

   

2. Prześlij aplikację, która zawiera shortcuts.xml, do w Konsoli Google Play w normalny sposób.

3. Gdy prześlesz aplikację do Konsoli Play, Google skontaktuje się z Tobą na e-mail na koncie w Konsoli Play z dodatkowymi informacjami o stanie. Twojej aplikacji Sprawdzanie działań. Możesz też skontaktować się z Asystentem pomocy dla deweloperów z pytaniami o stan weryfikacji działań w aplikacji. W kontakcie formularza, podaj identyfikator pakietu aplikacji i wybierz App Action Review (Przegląd działań w aplikacji) Jak możemy Ci pomóc?.

.

Uwaga: jeśli dostęp do aplikacji jest ograniczony i wymaga danych logowania, podaj testowe z przesłaniem aplikacji. Aby podać testowe dane logowania, wybierz aplikację w w Konsoli Play, wybierz Zasady > zawartości aplikacji i postępuj zgodnie z instrukcje dotyczące dostępu aplikacji.

Opcjonalnie: przetestuj precyzyjne linki do aktywności

Aby użyć precyzyjnego linku do uruchamiania Activity za pomocą akcji w aplikacji, Activity musi być skonfigurowany z użyciem adresów URL precyzyjnych linków i mieć odpowiedni filtr intencji w manifeście aplikacji na Androida.

Uwaga: precyzyjny link może się opierać na adresach URL linków aplikacji, adresy URL oparte na zamiarach lub schematy niestandardowe, takie jak myapp://do.thing/param=value

.

Aby sprawdzić, czy Twoje aktywności są dostępne i można je aktywować za pomocą Akcje w aplikacji, używając precyzyjnych linków, uruchom to polecenie adb:

$ adb shell am start -a android.intent.action.VIEW -d "AppLinksURL"

Na przykład:

$ adb shell am start -a android.intent.action.VIEW -d "https://www.example.com/deeplink"

Jeśli aktywność nie uruchomi się poprawnie za pomocą polecenia adb, sprawdź te kwestie:

• W pliku manifestu aplikacji aktywność zawiera element android:exported=true, więc może można uruchamiać przy użyciu intencji Asystenta Google.
• Jeśli używasz adresów URL linków aplikacji, wykonaj wszystkie czynności opisane w Obsługa linków aplikacji na Androida

Zasady dotyczące akcji w aplikacji

Akcje w aplikacji muszą być zgodne z określonymi zasadami. które wywołują u nich to zamierzone działanie. Zapoznaj się z tymi zasadami przed przesyłania aplikacji, aby zadbać o wygodę użytkowników i uniknąć Google Play. Opóźnienia lub odrzucenia opinii w sklepie.

• Kierowanie użytkowników do treści zamierzonych przez użytkowników

  Intencje wbudowane lub parametry Akcji w aplikacji mogą kierować użytkowników tylko do odpowiednie, zamierzone działanie użytkownika. Mogą to być treści w aplikacji, treści witryny i informacji wyświetlanych na wycinkach lub widżetach, o ile która była zamierzona przez użytkownika.

  Na przykład implementacje Centrum pomocy ORDER_MENU_ITEM BII. złożyć zamówienie na określoną pozycję menu lub rodzaj kuchni. Jedyna wyjątkiem od tej zasady jest sytuacja, w której OPEN_APP_FEATURE BII kieruje użytkowników na ekranie głównym aplikacji.

• Kierowanie użytkowników do odpowiednich treści z internetu

  Jeśli użytkownicy są przekierowywani na treść strony internetowej, witryna musi być związana z zamierzone działanie, które należy do marki.

  Na przykład przekierowywanie użytkowników, którzy zastosowali regułę, Twój GET_RESERVATION BII na google.com/travel, który nie należy do marka Twojej aplikacji exampledomain.com stanowi naruszenie zasad. Inny przykład naruszenie polega na przekierowaniu użytkowników, którzy wywołali GET_CALL_HISTORY BII, na exampledomain.com/payment i wymaga od nich dokonania zakupu.

• wdrażać odpowiednie wskaźniki BII dotyczące działań w aplikacji

  Wdrożone wskaźniki BII muszą być bezpośrednio związane z zawartością aplikacji funkcji.

  Jeśli na przykład Twoja aplikacja należy do kategorii „Komunikacja w Sklepie Play”, nie implementują ORDER_MENU_ITEM BII, które jest rekomendowane w przypadku aplikacji z kategorii Jedzenie i napoje.

• Implementowanie odpowiednich niestandardowych intencji

  Zdefiniowane zapytania kierowane na niestandardowe intencje odnoszą się do treści aplikacji oraz funkcji. Oto przykład potencjalnego naruszenia tworzy intencję custom.action.intent.GET_RECIPE z powiązany wzorzec zapytania „Pokaż przepisy na burrito” dla aplikacji na Kategoria Transport w Sklepie Play.

---