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

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 :

  1. Utwórz zasób shortcuts.xml, wykonując instrukcje podane w sekcji Tworzenie statycznych skrótów.
  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 w ramach App Actions używają BII Action IDdo nazw funkcji, które znajdziesz w dokumentacji BII. Na przykład BII GET_THING podaje 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 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 BII exercise.name i sposobie przekazywania wartości parametru – zebranych. od użytkownika jako dodatkowe dane w intent.

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