Dodaj możliwości do skrótów

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 :

  1. Utwórz zasób shortcuts.xml, postępując zgodnie z instrukcjami w sekcji Tworzenie zasobu statyczne skróty.

  2. 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 jako actions.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 elemencie capability.

    • Mapowanie parametrów: każdy element intent może zawierać parametry do przekazywane jako dane intencji extra. 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 BII exercise.name i sposobie przekazywania wartości parametru – zebranych. od użytkownika jako dodatkowe dane w intent.

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ń.