Tworzenie działań w aplikacji

Akcje w aplikacji umożliwiają użytkownikom uruchamianie funkcji w aplikacji na Androida za pomocą Asystenta Google lub skrótów na Androidzie zaproponowanych przez Asystenta. Oto główne kroki, które pozwalają wzbogacić aplikację na Androida o działania w aplikacji:

1. Określ funkcję w aplikacji, która ma zostać aktywowana, i odpowiadającą jej intencję wbudowaną (BII).
2. Podaj szczegóły realizacji zamówienia BII.
3. wysyłać skróty do Asystenta z Twojej 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 działań w aplikacji.

Opcjonalnie możesz zdefiniować dynamiczne skróty, które udostępnisz Asystentowi, aby mógł je sugerować użytkownikom. Wykonaj ćwiczenie z programowania w Akcjach w aplikacji, aby utworzyć akcję w aplikacji za pomocą przykładowej aplikacji.

Uwaga: ze względu na ograniczenia prawne aplikacje uczestniczące w programie Dla całej rodziny (DFF) nie mogą zawierać akcji w aplikacji. Jeśli prześlesz do sprawdzenia działanie aplikacji, które jest częścią programu Dla całej rodziny, nie zostanie ono 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 Konsoli Google Play.
• Aplikacja musi być opublikowana w Sklepie Google Play, ponieważ akcje aplikacji są dostępne tylko w przypadku aplikacji opublikowanych w tym sklepie. Upewnij się też, że Twoja aplikacja nie jest przeznaczona do użytku w profilu służbowym, ponieważ akcje w aplikacji nie są obsługiwane przez zarządzany Sklep Google Play.
• Aby przetestować Akcje w aplikacji, musisz mieć urządzenie fizyczne lub wirtualne.
• Musisz mieć najnowszą wersję Android Studio.
• Aby zalogować się w Android Studio, aplikacji Google na urządzeniu testowym i Konsoli Google Play, musisz użyć tego samego konta Google.
• Musisz skonfigurować Asystenta na urządzeniu testowym i przetestować go, naciskając i przytrzymując przycisk ekranu głównego.

dopasowywać wbudowane intencje do funkcji aplikacji;

Określ funkcje w aplikacji na Androida, do których użytkownicy mogą przejść za pomocą poleceń głosowych, i sprawdź wbudowane odwołania do intencji, aby znaleźć odpowiednie interfejsy BIIs do swoich zastosowań. Modele BII odpowiadają na zapytania użytkowników dotyczące zadań, które chcą wykonać. Poszukaj więc modeli BII, które pasują do kluczowych funkcji i przepływów danych w aplikacji.

Istnieją standardowe interfejsy BII, których może używać prawie każda aplikacja na Androida, np. rozszerzenie wyszukiwania w aplikacji o Asystenta za pomocą interfejsu BII actions.intent.GET_THING lub umożliwienie użytkownikom uruchamiania określonych funkcji aplikacji za pomocą głosu dzięki implementacji interfejsu BII actions.intent.OPEN_APP_FEATURE.

Ważne: zgodnie z wymaganiami dotyczącymi wdrażania akcji w aplikacji w przypadku aplikacji z funkcją wyszukiwania należy zaimplementować actions.intent.GET_THING BII, aby użytkownicy mogli wyszukiwać treści w aplikacji za pomocą popularnych poleceń głosowych, takich jak OK Google, wyszukaj buty do biegania w aplikacji Przykładowa aplikacja

.

Istnieją też BIIs, które umożliwiają stosowanie w przypadkach użycia związanych z branżą lub z konkretną kategorią. Na przykład aplikacja do ćwiczeń może korzystać z BII actions.intent.START_EXERCISE.

Uwaga: jeśli funkcja aplikacji nie ma interfejsu BII, możesz użyć intencji niestandardowej, aby rozszerzyć aplikację o działania aplikacji.

Aby zapewnić użytkownikom wygodę i uniknąć opóźnień w zatwierdzaniu, upewnij się, że każda implementacja interfejsu BII jest odpowiednia dla funkcji w aplikacji.

Działania aplikacji działają poprzez uruchamianie intencji Androida z aplikacji Asystent, aby kierować użytkowników bezpośrednio do określonej zawartości w aplikacji. Możesz zdefiniować intencje, aby uruchamiać aktywność wprost, podając pola targetClass i targetPackage. Jeśli Twoja aplikacja już korzysta z adresów URL precyzyjnych linków na Androida, możesz skonfigurować zamiar tak, aby używał precyzyjnego linku do realizacji. Więcej informacji znajdziesz w sekcji Testowanie precyzyjnych linków w Aktywności.

Podaj szczegóły realizacji dla intencji wbudowanych

Większość tworzenia akcji w aplikacji polega na zadeklarowaniu możliwości w pliku zasobów shortcuts.xml aplikacji na Androida, w którym określasz wybrany obiekt BII i odpowiadającą mu realizację. Narzędzie BII modeluje zapytanie użytkownika dotyczące zadania, a intencja realizacji dostarcza Asystentowi informacji o tym, jak je wykonać.

W pliku shortcuts.xml identyfikatory BI są reprezentowane przez elementy <capability>, a każda realizacja jest reprezentowana przez 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 Android Jetpack.

W przypadku większości BII parametry intencji wyodrębniasz z zapytania użytkownika na podstawie encji schema.org. Aplikacja używa tych parametrów BII, aby kierować użytkowników do wybranej funkcji. Na przykład poprzedni kod mapuje parametr exercise.name BII na parametr exercise_nameAndroidintent.

Jeśli wykonujesz działania za pomocą precyzyjnych linków, w polu urlTemplate możesz zdefiniować, jaki URL precyzyjnego linku generuje Asystent:

<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 udostępnia wiele intencji do zrealizowania w przypadku 1 BII, Asystent próbuje je rozwiązać w kolejności, w jakiej występują w elemencie capability.

Ważne informacje o dodawaniu działań w aplikacji do pliku shortcuts.xml znajdziesz w sekcji Tworzenie pliku shortcuts.xml. Na tej stronie znajdziesz też informacje o tym, jak określić wartości parametrów wymaganych przez aplikację.

Wdróż wbudowaną intencję GET_THING

Jeśli Twoja aplikacja ma funkcję wyszukiwania, musisz zaimplementować dla niej interfejs BIIactions.intent.GET_THING. Gdy użytkownicy będą wypowiadać zapytania, takie jak „OK Google, wyszukaj przykładową rzecz w aplikacji Przykładowa”, Asystent może przekierowywać ich do funkcji wyszukiwania w aplikacji, aby wyświetlić wyniki w aplikacji.

W pliku shortcuts.xml zaimplementuj <capability> dla actions.intent.GET_THING BII tak samo jak w przypadku innych BII. W przypadku funkcji GET_THING możesz użyć wielu funkcji realizacji, o ile udostępnisz co najmniej jedną funkcję realizacji, która przekazuje zapytanie użytkownika do funkcji wyszukiwania w aplikacji.

Oto przykład dodawania informacji o związku actions.intent.GET_THING w elementach 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 wyszukiwarce Activity wyodrębnij zapytanie z dodatkowych danych intent i przekaż je do funkcji wyszukiwania w aplikacji. W powyższym kodzie zapytanie o wyszukiwanie przekazane jako klucz query jest mapowane na parametr "thing.name" BI. Następnie przeprowadź wyszukiwanie za pomocą zapytania i wyświetl wyniki w interfejsie.

Opcjonalnie: wysyłaj skróty do działania aplikacji do Asystenta

Gdy zdefiniujesz możliwości działania, użytkownicy będą mogli je uruchomić, mówiąc na przykład „OK Google, zamów pizzę w aplikacji Przykładowa aplikacja”. Asystent może w odpowiednich momentach sugerować użytkownikom skróty do Twoich działań na urządzeniu z Androidem, aby mogli je odkrywać i odtwarzać. Asystent może sugerować skróty dynamiczne i statyczne.

Aby przekazać dynamiczne skróty do Asystenta, użyj biblioteki integracji skrótów Google. Ta biblioteka Jetpacka umożliwia Asystentowi pobranie skrótów i ich sugerowanie użytkownikom we właściwym czasie.

Więcej informacji znajdziesz w artykule Dynamiczne przesyłanie skrótów do Asystenta.

Podgląd akcji w aplikacji

W trakcie programowania i testowania użyj wtyczki Asystenta Google do Android Studio, by sprawdzić, czy akcje w aplikacji działają w Twojej aplikacji. Wtyczka tworzy w Asystencie podgląd akcji w aplikacji na Twoim koncie Google. Za pomocą narzędzia testowego możesz testować realizację na fizycznym urządzeniu testowym lub w emulatorze, podając BIIs parametry wejściowe, które oczekujesz od użytkowników.

Uwaga: możesz też dodać dodatkowych testerów do integracji z Akcjami w aplikacji, nawet jeśli nie mają oni tego samego konta w Konsoli Play. Więcej informacji znajdziesz w artykule Dodawanie kolejnych testerów.

Podczas wyświetlania podglądu działań w aplikacji możesz uruchamiać zapytania głosowe na urządzeniu. Ta funkcja jest dostępna tylko w przypadku zapytań wymienionych w dokumentacji BII dotyczącej akcji w aplikacji. Używaj poleceń głosowych tylko do pokazu, a nie do regularnych 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 języków.

Zanim prześlesz aplikację do sprawdzenia, przetestuj ją w trybie szkicu za pomocą narzędzi dla deweloperów w Konsoli Google Play. Więcej informacji o publikowaniu wersji roboczej aplikacji w Konsoli Google Play znajdziesz w artykule Przygotowanie i publikowanie wersji aplikacji.

Tworzenie wersji testowej

Gdy będziesz gotowy/gotowa do testowania akcji aplikacji z dodatkowymi testerami, utwórz wersję testową aplikacji wewnętrznej lub zamkniętej. Domyślnie testerzy wersji wewnętrznej i zamkniętej mają dostęp do akcji aplikacji, które zostały już przeanalizowane i zatwierdzone.

Aby przyznać dostęp do testowania wszystkich akcji w aplikacji, w tym tych niezatwierdzonych, poproś testerów o dołączenie do grupy Google Program rozwoju akcji w aplikacji. Członkowie tej grupy mają dostęp do wszystkich wersji testów zamkniętych i wewnętrznych aplikacji, bez konieczności tworzenia podglądów za pomocą narzędzia do testowania działań aplikacji. Po dołączeniu do grupy dostęp może być dostępny po upływie 3 godzin.

Uwaga: działania w wersjach aplikacji na ścieżce testów otwartych są niedostępne dla użytkowników, dopóki nie zostaną sprawdzone i zatwierdzone. Więcej informacji znajdziesz w następnej sekcji.

Prośba o sprawdzenie i wdrożenie działań w aplikacji

Akcje w aplikacji nie będą dostępne dla użytkowników Twoich opublikowanych aplikacji ani wersji do testów otwartych, dopóki nie zostaną sprawdzone i zatwierdzone. Sprawdzanie aplikacji nie wpływa na stan weryfikacji i wdrażania aplikacji na Androida w Google Play. Nawet jeśli przesłana aplikacja została 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.

Gdy wdrożesz aplikację, jej działania pozostaną aktywne. Jednak w przypadku ponownie wdrożonych wersji Google może je sprawdzić. Jeśli nowa wersja nie działa prawidłowo lub zawiera naruszenia zasad, Google ma prawo do dezaktywowania akcji aplikacji w Twojej 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ę zawierającą shortcuts.xml do Konsoli Google Play w zwykły sposób w celu jej opublikowania.

3. Gdy prześlesz aplikację do Konsoli Play, Google skontaktuje się z Tobą, wysyłając e-maila na konto Konsoli Play, aby przekazać Ci dodatkowe informacje o stanie weryfikacji działań w aplikacji. Jeśli masz pytania dotyczące stanu sprawdzania akcji w aplikacji, możesz też skontaktować się z zespołem pomocy dla deweloperów Asystenta. W formularzu kontaktowym podaj identyfikator pakietu aplikacji, a w polu wyboru Jak możemy Ci pomóc? wybierz Sprawdzanie działań w aplikacji.

Uwaga: jeśli dostęp do aplikacji jest ograniczony na podstawie danych logowania, podaj dane testowego logowania podczas przesyłania aplikacji. Aby podać dane logowania do wersji testowej, wybierz aplikację w Konsoli Play, kliknij Zasady > Zawartość aplikacji i postępuj zgodnie z instrukcjami dotyczącymi dostępu do aplikacji.

Opcjonalnie: przetestuj precyzyjne linki do aktywności

Aby użyć precyzyjnego linku do uruchamiania Activity za pomocą działania w aplikacji, w Activity musisz skonfigurować adresy URL precyzyjnych linków i mieć odpowiedni filtr intencji w pliku manifestu aplikacji na Androida.

Uwaga: precyzyjny link może być oparty na adresach URL linków aplikacji, adresach URL opartych na intencjach lub schematach niestandardowych, takich jak myapp://do.thing/param=value.

Aby sprawdzić, czy Twoje działania są dostępne i czy można je wywołać za pomocą działań w aplikacji z użyciem 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 uruchamia się poprawnie za pomocą polecenia adb, sprawdź te kwestie:

• W pliku manifestu aplikacji aktywność ma wartość android:exported=true, więc można ją uruchomić za pomocą intencji z Asystenta Google.
• Jeśli używasz adresów URL linków aplikacji, wykonaj wszystkie czynności opisane w artykule 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ą, mieli zapewnione oczekiwane wrażenia. Zanim prześlesz aplikacje, zapoznaj się z tymi zasadami, aby zapewnić użytkownikom jak najlepsze wrażenia i uniknąć opóźnień lub odrzuceń w Sklepie Play.

• Kierowanie użytkowników do treści przeznaczonych dla użytkowników

  Wbudowane intencje (BIIs) lub parametry działania aplikacji muszą kierować użytkowników tylko do odpowiedniego działania, które jest zgodne z zamiarem użytkownika. Mogą to być treści w aplikacji, treści w witrynie lub informacje wyświetlane w slajdach lub widżetach, o ile tylko użytkownik wyraził na to zgodę.

  Na przykład implementacje START_EXERCISE BII pomagają użytkownikom rozpocząć ćwiczenia określonego typu, np. bieganie lub pływanie. Jedynym wyjątkiem od tej zasady jest sytuacja, gdy interfejs BII OPEN_APP_FEATURE kieruje użytkowników na ekran główny aplikacji.

• Wdrażanie odpowiednich interfejsów API BI dotyczących działań w aplikacji

  Wdrożone BIIs muszą być bezpośrednio związane z zawartością i funkcjami aplikacji.

  Jeśli na przykład Twoja aplikacja należy do kategorii Komunikacja w Google Play, nie implementuj interfejsu biznesowego interfejsu interfejsu API 2.0 START_EXERCISE, który jest zalecany w przypadku aplikacji z kategorii Zdrowie i fitness.

• Wdrażanie odpowiednich niestandardowych intencji

  Zapytania zdefiniowane dla niestandardowych intencji odnoszą się do treści i funkcji aplikacji. 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.

---