Tworzenie działań w aplikacji

Działania aplikacji umożliwiają użytkownikom uruchamianie funkcji w aplikacji na Androida przez Asystenta Google lub za pomocą skrótów na Androida sugerowanych 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, sprawdź, czy Ty i Twoja aplikacja spełniacie te 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 przetestować Akcje 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 ćwiczeń może korzystać z funkcji actions.intent.START_EXERCISE 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 zapewnić użytkownikom wygodę korzystania z aplikacji i uniknąć opóźnień w zatwierdzaniu, upewnij się, że każda implementacja interfejsu BII jest odpowiednia dla funkcji w 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 już korzysta z adresów URL precyzyjnych linków na Androida, możesz skonfigurować zamiar, aby używał precyzyjnego linku do realizacji. Więcej informacji znajdziesz w artykule Przeprowadzanie szczegółowych testów aktywności linki.

Podawanie szczegółów realizacji w przypadku wbudowanych intencji

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.START_EXERCISE">
        <intent
            android:action="android.intent.action.VIEW"
            android:targetPackage="com.example.app"
            android:targetClass="com.example.app.browse">
            <parameter
                android:name="exercise.name"
                android:key="exercise_name">
            </parameter>
        </intent>
    </capability>

Uwaga: w projekcie na Androida musi być zawarta biblioteka Jetpack androidx.core:core:1.6.0 (lub nowsza wersja), aby uniknąć błędów kompilacji podczas definiowania funkcji działań aplikacji 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 BII exercise.name na Androida w systemie exercise_name intent.

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.START_EXERCISE">
        <intent android:action="android.intent.action.VIEW">
            <url-template android:value="myexerciseapp://start{?exercise_name}" />
            <parameter android:name="exercise.name"
                android:key="exercise_name"
                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 element.

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

Implementacja wbudowanej intencji 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 tak samo jak w przypadku innych 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ą narzędzia do testowania możesz testować odpowiedzi na urządzeniach testowych lub w emulatorze, podając BIIs parametry wejściowe, które 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 dokumentacji BII dotyczącej akcji w aplikacji. Użyj głosu wyzwalanie tylko w celach demonstracyjnych, a nie do zwykłych testów.

Uwaga: narzędzie do testowania działań w aplikacji obsługuje testowanie BIIs tylko w języku angielskim (USA), chyba że w odpowiednim opisie wbudowanego zamiaru

podano przykładowe zapytania dotyczące innych lokalizacji.

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 znajdziesz 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, Google może nadal sprawdzać Twoją aplikację (shortcuts.xml). Działania w aplikacji nie będą działać dla użytkowników końcowych, dopóki nie zostanie zatwierdzona ta weryfikacja.

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 ma 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 tak jak zwykle.

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 formularzu kontaktu podaj identyfikator pakietu aplikacji i w polu wyboru Jak możemy Ci pomóc? wybierz Sprawdzanie działania aplikacji.

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, aby użytkownicy, którzy je uruchamiają, mogli uzyskać oczekiwane wrażenia. 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 START_EXERCISE BII. rozpocznij ćwiczenie określonego rodzaju, takie jak bieganie czy pływanie. Jedynym wyjątkiem od tej zasady jest sytuacja, gdy interfejs biznesowy OPEN_APP_FEATURE kieruje użytkowników na ekran główny aplikacji.

• 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 np. Twoja aplikacja należy do kategorii Komunikacja w Google Play, nie implementuj interfejsu biznesowego interfejsu API II START_EXERCISE, który jest zalecany w przypadku aplikacji z kategorii Zdrowie i fitness.

• Implementowanie odpowiednich niestandardowych intencji

  Zdefiniowane zapytania kierowane na niestandardowe intencje odnoszą się do treści aplikacji oraz funkcji. Przykładem potencjalnego naruszenia tej zasady jest utworzenie intencji custom.action.intent.GET_RECIPE z powiązanym wzorcem zapytania „Pokaż przepisy na burrito” w przypadku aplikacji z kategorii Transport w Sklepie Play.

---