Wbudowane intencje działań w aplikacji

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.

Rysunek 1. Wywołaj START_EXERCISE BII za pomocą głosu i zapytać Asystenta.
Rysunek 2. Uruchamianie aplikacji na określonym ekranie aby rozpocząć zadanie START_EXERCISE.
Rysunek 3. Wyświetla widżet w odpowiedzi na zapytanie.

​

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:

  1. Zadeklaruj capability z wybranym ustawieniem BII.
  2. Dodaj zagnieżdżone elementy parameter w każdym polu BII, które chcesz dodać.
    1. Jeśli używasz aplikacji targetClass lub targetPackage, zmapuj je na Androida intencję extras, używając wybranej przez Ciebie nazwy.
    2. Jeśli używasz adresu URL precyzyjnego linku, użyj nazwanych parametrów w zapytaniu w szablonie adresu URL.

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.