Uprawnienia w aplikacji shortcuts.xml
umożliwiają zadeklarowanie typów działań, które mogą wykonywać użytkownicy
uruchomienia aplikacji i bezpośredniego wykonania określonego zadania.
Na przykład akcje w aplikacji Asystenta Google korzystają z funkcji, które pozwalają deweloperom
Rozszerzać funkcje aplikacji o intencje wbudowane, umożliwiając użytkownikom
i sterować tymi funkcjami za pomocą poleceń głosowych. Zdolność to:
nazwę działania i intent
kierowane na miejsce docelowe w aplikacji, które
przekonuje użytkownika do zakupu.
Zdefiniuj uprawnienia w plikushort.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
, postępując zgodnie z instrukcjami w sekcji Tworzenie zasobu statyczne skróty. 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 dotyczące akcji w aplikacji używają BII
Action ID
. Przykład:GET_THING
BII wyświetla pozycjęAction 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 poprzednim 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ąż skróty z funkcją
Po zdefiniowaniu funkcji możesz ją rozszerzyć, tworząc powiązanie
statyczne lub dynamiczne skróty. Jak skróty są powiązane z kontem capability
zależy od implementowanej funkcji oraz rzeczywistych słów zawartych w
na żądanie 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ń.