Wbudowane intencje umożliwiają aplikacji wyrażenie możliwości realizacji o korzystaniu. Jeśli deklarujesz uprawnienia w pliku skróty.xml i mapowania parametrów intencji na realizację, umożliwiasz w Asystencie Google, aby uruchomić aplikację na określonym ekranie w odpowiedzi na aby użytkownik mógł wykonać zadanie.
Intencje wbudowane są pogrupowane według kategorii aplikacji. Każda kategoria To zestaw typowych czynności, które użytkownicy często chcą wykonać na aplikacji. Pełna lista dostępnych BII, ich parametrów i przykład i zapytania, których można używać do testowania, znajdziesz tutaj.
Wiele z nich ma określone wymagania w zakresie wdrażania o zaleceniach. Te wymagania i zalecenia pomogą Twojej aplikacji zapewniają użytkownikom najlepsze wrażenia.
![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness1.png?authuser=19&hl=pl)
START_EXERCISE
BII za pomocą głosu
i zapytać Asystenta.![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness3.png?authuser=19&hl=pl)
START_EXERCISE
.![](https://developer.android.google.cn/static/guide/app-actions/images/Fitness4-widget.png?authuser=19&hl=pl)
Wdróż interfejsy BIi i obsługuj parametry intencji
W przypadku akcji w aplikacji deklarujesz możliwości i obsługujesz parametry BII w pliku quick.xml. Aby wdrożyć BII i obsługiwać , wykonaj następujące kroki:
- Zadeklaruj
capability
z wybranym ustawieniem BII. - Dodaj zagnieżdżone elementy
parameter
w każdym polu BII, które chcesz dodać.- Jeśli używasz aplikacji
targetClass
lubtargetPackage
, zmapuj je na Androida intencjęextras
, używając wybranej przez Ciebie nazwy. - Jeśli używasz adresu URL precyzyjnego linku, użyj nazwanych parametrów w zapytaniu w szablonie adresu URL.
- Jeśli używasz aplikacji
Aby obsługiwać parametr BII, zmapuj go na
odpowiadający parametrowi wyraźnej intencji Androida w tagu capability
.
Następnie możesz wykorzystać jego wartość w swojej aplikacji. Aplikacja nie jest wymagana do obsługi
Parametry BII. Spróbuj jednak obsługiwać pola danych oznaczone jako „Zalecane”
w dokumentacji intencji wbudowanej.
Możesz zdefiniować wiele realizacji intencji, każdą z osobnym zbiorem zalecanych parametrów. Google wybiera odpowiednią realizację na podstawie parametrów możliwości zidentyfikowanych w zapytaniu użytkownika oraz zadeklarowanych w intencjach.
Na przykład actions.intent.START_EXERCISE
intencja zaleca, aby aplikacja obsługiwała parametr exercise.name
BII, ale
może zaimplementować BII w Twojej aplikacji bez parametrów.
Warto to zrobić, jeśli chcesz obsługiwać zapytania użytkowników bez
nazwę ćwiczenia, na przykład „Poproś Przykładowa aplikację, aby rozpocząć śledzenie ćwiczenia”.
ten fragment kodu zawiera kreację zastępczą bez wymaganych parametrów jeśli zapytanie użytkownika nie zawiera tych parametrów:
<?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>
Asystent Google stara się dostarczać najbardziej przydatne informacje użytkownika przy zwracaniu wartości parametrów do aplikacji. Na przykład zapytania użytkowników za zamówienie pizzy w aplikacji mobilnej Przykładowa restauracja nie zawsze zawiera lokalizacji. Aby ułatwić użytkownikowi obsługę, Asystent może podać szerokość geograficzną długości i długości geograficznej najbliższej restauracji Przykładowej do tej aplikacji.
Dodatkowym wymaganiem jest to, że nie chcesz, aby aplikacja bezpośrednio wykonywała działanie, które zmienia rzeczywisty stan użytkownika (np. przeniesienie pieniądze, złożenie zamówienia czy wysłanie wiadomości) bez wcześniejszego potwierdzenia z użytkownikiem.
Ujednoznacznienie
Argumenty przekazywane do aplikacji przez <url-parameter>
lub dodatki do intencji mogą nie
jednoznacznie identyfikują produkt, który chcesz pokazać użytkownikowi. W tym przypadku
użyj wartości argumentu jako argumentu wyszukiwania i przekieruj użytkownika do strony wyszukiwania
stronie aplikacji. Pozwala precyzyjnie określić i wybrać właściwy element.
Jeśli np. użytkownik wpisze zapytanie „Zamówienie z przykładowej restauracji” w przypadku witryny
BII ORDER_MENU_ITEM
, możesz zaprezentować użytkownikowi listę
restauracje, których nazwy pasują do hasła "Example Restaurant"
.
Obsługa języków i regionów
Języki obsługiwane na potrzeby programowania i testowania przez każde działanie w aplikacji BII są wymienione w dokumentacji intencji wbudowanej. Niektóre wskaźniki BII różnią się obsługa języka na potrzeby testowania przez deweloperów i wyzwalania przez użytkownika za pomocą Asystenta.