Uprawnienia w aplikacji shortcuts.xml
umożliwiają zadeklarowanie rodzajów działań, które mogą wykonywać użytkownicy
uruchomienia aplikacji i bezpośredniego wykonania określonego zadania.
Na przykład Akcje aplikacji Asystenta Google korzystają z możliwości, które umożliwiają deweloperom rozszerzanie funkcji aplikacji o wbudowane intencje (BIIs), dzięki czemu użytkownicy mogą aktywować te funkcje i nimi sterować za pomocą poleceń głosowych. Umiejętność składa się z nazwy działania i intent
kierowania na miejsce docelowe w aplikacji, które realizuje zamiar użytkownika.
Definiowanie możliwości w pliku shortcuts.xml
Elementy capability
definiuje się w pliku zasobów shortcuts.xml
w
Projekt tworzenia aplikacji na Androida. Aby zdefiniować element capability
, wykonaj
:
- Utwórz zasób
shortcuts.xml
, wykonując instrukcje podane w sekcji Tworzenie statycznych skrótów. Uwzględnij w swojej funkcji te wymagane informacje:
Nazwa funkcji: działanie, które ma obsługiwać aplikacja. Więcej informacji: dokumentacja komponentu funkcji, która wymaga funkcji definicji. Polecenia głosowe w ramach App Actions używają BII
Action ID
do nazw funkcji, które znajdziesz w dokumentacji BII. Na przykład BIIGET_THING
podajeAction ID
jakoactions.intent.GET_THING
.Miejsce docelowe aplikacji: miejsce docelowe w aplikacji, w którym powoduje uruchomienie działania. spełnić prośbę użytkownika. Określ miejsca docelowe aplikacji za pomocą elementów
intent
umieszczone w elemenciecapability
.Mapowanie parametrów: każdy element
intent
może zawierać parametry do przekazywane jako dane intencjiextra
. Na przykład każde Akcje w aplikacji BII zawiera pola reprezentujące informacje często podawane przez użytkowników w zapytaniach, które wywoła BII.
Poniższy przykład ilustruje definicję możliwości w języku shortcuts.xml
.
dla actions.intent.START_EXERCISE
– usługi BII, która umożliwia użytkownikom
aby rozpocząć trening w aplikacji do fitnessu za pomocą Asystenta:
<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:targetPackage="com.example.sampleApp"
android:targetClass="com.example.sampleApp.ExerciseActivity">
<parameter
android:name="exercise.name"
android:key="exerciseType"/>
</intent>
</capability>
</shortcuts>
W powyższym przykładzie atrybut <capability>
android:name
odnosi się do START_EXERCISE
BII. Jeśli użytkownik wywoła ten wskaźnik BII, mówiąc do Asystenta: „OK”
Google, rozpocznij uruchomienie w przykładowej aplikacji”, Asystent spełnia prośbę użytkownika, używając polecenia
informacji podanych w zagnieżdżonym elemencie intent
. intent
w tym fragmencie
określa następujące szczegóły:
android:targetPackage
ustawia docelowy pakiet aplikacji dla tego intencji.- Pole
android:targetClass
określa aktywność docelową:com.example.sampleApp.ExerciseActivity
. - Intencja
parameter
deklaruje obsługę parametru BIIexercise.name
i sposobie przekazywania wartości parametru – zebranych. od użytkownika jako dodatkowe dane wintent
.
Powiązanie skrótów z funkcją
Po zdefiniowaniu możliwości możesz rozszerzyć jej funkcjonalność, powiązać z nią skróty statyczne lub dynamiczne. Sposób łączenia skrótów z capability
zależy od implementowanej funkcji i rzeczywistych słów zawartych w żądaniu użytkownika. Na przykład, gdy użytkownik rozpocznie bieg w ramach funkcji monitorowania aktywności
aplikacji, mówiąc do Asystenta: „OK Google, uruchom uruchomienie w aplikacji PrzykładowaAplikacja”. Asystent
może użyć skrótu do uruchomienia instancji capability
, która definiuje prawidłową
element ćwiczenia „bieg” dla parametru exercise.name
.
Więcej informacji o łączeniu skrótów z akcjami w aplikacji znajdziesz w sekcji Aplikacja Omówienie działań.