Zintegruj akcje w aplikacji z widżetami na Androida

package com.example.exampleapp

//... Other module imports
import com.google.assistant.appactions.widgets.AppActionsWidgetExtension

/**
 * Implementation of App Widget functionality.
 */
object MyAppWidget : AppWidgetProvider() {
    fun updateAppWidget(
        context: Context?,
        appWidgetManager: AppWidgetManager,
        appWidgetId: Int
    ) {
        val appActionsWidgetExtension = AppActionsWidgetExtension.newBuilder(appWidgetManager)
            .setResponseSpeech("Hello world") // TTS to be played back to the user
            .setResponseText("Hello world!") // Response text to be displayed in Assistant
            .build()

        // Update widget with TTS
        appActionsWidgetExtension.updateWidget(appWidgetId)

        // Update widget UI
        appWidgetManager.updateAppWidget(appWidgetId, views)
    }
}

package com.example.exampleapp;

//... Other module imports
import com.google.assistant.appactions.widgets.AppActionsWidgetExtension;

/**
 * Implementation of App Widget functionality.
 */
public class MyAppWidget extends AppWidgetProvider {

  static void updateAppWidget(Context context, AppWidgetManager appWidgetManager,
    int appWidgetId) {

    AppActionsWidgetExtension appActionsWidgetExtension = AppActionsWidgetExtension.newBuilder(appWidgetManager)
      .setResponseSpeech("Hello world")  // TTS to be played back to the user
      .setResponseText("Hello world!")  // Response text to be displayed in Assistant
      .build();

      // Update widget with TTS
      appActionsWidgetExtension.updateWidget(appWidgetId);

      // Update widget UI
      appWidgetManager.updateAppWidget(appWidgetId, views);
    }

}

Rekomendacje dotyczące stylu TTS

Skorzystaj z poniższych zaleceń dotyczących stylu, aby zoptymalizować niestandardowy widżet. wprowadzenia do zamiany tekstu na mowę i wyświetlanych promptów.

Przypinanie programu uruchamiającego

W bibliotece rozszerzeń widżetów można wyświetlać przycisk Dodaj ten widżet za pomocą widżetu w Asystencie. Aby włączyć przypinanie, dodaj ten odbiornik definicja na AndroidManifest.xml:

<application>
  <receiver android:name="com.google.assistant.appactions.widgets.pinappwidget.PinAppWidgetBroadcastReceiver"
    android:exported="false">
    <intent-filter>
      <action android:name="com.google.assistant.appactions.widgets.COMPLETE_PIN_APP_WIDGET" />
    </intent-filter>
  </receiver>
  <service
    android:name=
    "com.google.assistant.appactions.widgets.pinappwidget.PinAppWidgetService"
    android:enabled="true"
    android:exported="true">
    <intent-filter>
      <action
        android:name="com.google.assistant.appactions.widgets.PIN_APP_WIDGET" />
    </intent-filter>
  </service>
</application>

Dostępność zasobów reklamowych

BII obsługują wbudowane zasoby reklamowe lub internetowe zasoby reklamowe, zasobów reklamowych w realizacji Twoich widżetów.

Wbudowane zasoby reklamowe

Poniższy kod z przykładowego pliku shortcuts.xml przedstawia Możliwości START_EXERCISE BII skonfigurowana pod kątem realizacji wbudowanych zasobów reklamowych i widżetów:

<capability
  android:name="actions.intent.START_EXERCISE">
  <app-widget
    android:identifier="START_EXERCISE_1"
    android:targetClass="com.example.exampleapp.StartExerciseAppWidgetProvider">
    <parameter
      android:name="exercise.name"
      android:key="exerciseName"
      app:shortcutMatchRequired="true">
    </parameter>
  </app-widget>
</capability>

<shortcut android:shortcutId="RunningShortcut">
  <intent
    android:action="android.intent.action.VIEW"
    android:targetClass="com.example.exampleapp.StartExcerciseActivity" />
  <capability-binding
    android:capability="actions.intent.START_EXERCISE"
    android:parameter="exercise.name"
    android:value="running;runs" />
</shortcut>

W poprzednim przykładzie, gdy użytkownik aktywuje tę funkcję, prosząc o to Asystenta, „Zacznij biegać z przykładową aplikacją”, pakiet opcji dla operatora Realizacja <app-widget> zawiera tę parę klucz-wartość:

• Klucz = “exerciseName”
• Wartość = “RunningShortcut”

Zasoby reklamowe w internecie

Poniższy kod z przykładowego pliku shortcuts.xml pokazuje funkcję włączona na potrzeby realizacji zasobów reklamowych w internecie i widżetów:

<shortcuts>
  <capability
    android:name="actions.intent.START_EXERCISE">
    <app-widget
      android:identifier="START_EXERCISE_1"
      android:targetClass="com.example.exampleapp.CreateTaxiAppWidgetProvider">
      <parameter
        android:name="exercise.name"
        android:key="exerciseName"
        android:mimeType="text/*">
        <data android:pathPattern="https://exampleapp.com/exercise/.*" />
      </parameter>
    </app-widget>
  </capability>
</shortcuts>

Testuj działania w aplikacji

Użyj narzędzia App Actions Test Tool, które jest funkcją wtyczki Asystenta Google do Android Studio – umożliwia testowanie widżetów na urządzeniu fizycznym lub wirtualnym. Aby użyć funkcji w narzędziu testowym, wykonaj te czynności:

1. Połącz urządzenie testowe z uruchomioną aplikacją.
2. W Android Studio wybierz Narzędzia > Działania w aplikacji > Test działań w aplikacji .
3. Kliknij Utwórz podgląd.
4. Korzystając z Android Studio, uruchom aplikację na urządzeniu testowym.
5. Aby przetestować działanie w aplikacji, użyj aplikacji Asystent na urządzeniu testowym. Dla: Możesz na przykład powiedzieć „OK Google, ile kilometrów udało mi się przebiec w tym tygodniu w aplikacji ExampleApp?”.
6. Obserwuj działanie aplikacji lub użyj debugera Android Studio, aby: Sprawdź oczekiwane działanie.

Wytyczne dotyczące jakości

W tej sekcji omawiamy kluczowe wymagania i sprawdzone metody integrujesz akcje w aplikacji z widżetami.

Zawartość widżetów

• (Wymagane) – nie wyświetlaj reklam w widżetach.
• Całkowicie skoncentruj treść widżetu na spełnieniu intencji. Przeciwwskazania spróbuj zrealizować kilka intencji za pomocą jednego widżetu lub dodaj nieistotne treści.

Uwierzytelnienie

• (Wymagane) Jeśli do zakończenia ścieżki użytkownika wymagane jest uwierzytelnianie, wyświetlają widżet z informacją, że użytkownik musi kontynuować aplikację. Wbudowane uwierzytelnianie użytkowników w Asystencie Google nie jest obsługiwane w przypadku aplikacji Działania.
• Jeśli użytkownicy zezwalają aplikacji na wyświetlanie danych za pomocą widżetów, możesz zwrócić widżet błędu w trakcie działania dla nieautoryzowanych użytkowników.

Intencje zastępcze

• (Wymagane) W tabeli shortcuts.xml zawsze podawaj wartość zastępczą <intent> oprócz realizacji widżetu dla danej możliwości. Intencja kreacji zastępczej to element <intent>, który nie jest wymagany. <parameter> wartości.

  Dzięki temu Asystent może wykonać działanie, zapytanie użytkownika nie zawiera parametrów wymaganych przez inną realizację elementów zdefiniowanych w możliwości. Wyjątkiem jest sytuacja, w której parametry wymagane dla tej funkcji, w którym to przypadku dostępny jest tylko widżet i niezbędna jest realizacja zamówień.

• Użyj intencji zastępczej, aby otworzyć aplikację na odpowiednim ekranie, nie ekran główny.

Poniższy kod z przykładowego pliku shortcuts.xml przedstawia <capability> z wartością zastępczą <intent> obsługującą podstawową Realizacja zamówienia <app-widget>:

<shortcuts>
  <capability
    android:name="actions.intent.CREATE_TAXI_RESERVATION">
    <!-- Widget with required parameter, specified using the "android:required" attribute. -->
    <app-widget
      android:identifier="CREATE_TAXI_RESERVATION_1"
      android:targetClass="com.example.myapplication.CreateTaxiAppWidgetProvider">
      <parameter
        android:name="taxiReservation.dropoffLocation.name"
        android:key="dropoff"
        android:required="true">
      </parameter>
    </app-widget>
    <!-- Fallback intent with no parameters required to successfully execute. -->
    <intent
      android:identifier="CREATE_TAXI_RESERVATION_3"
      android:action="myapplication.intent.CREATE_TAXI_RESERVATION_1"
      android:targetClass="com.example.myapplication.TaxiReservationActivity">
    </intent>
  </capability>
</shortcuts>

Ujawnianie danych w Google Play

Ta sekcja zawiera listę danych użytkowników zebranych przez najnowszą wersję Biblioteka rozszerzeń widżetów.

Ten pakiet SDK wysyła dostarczone przez dewelopera odpowiedzi zamiany tekstu na mowę, które są wypowiadane przez Asystenta Google za pomocą mowy Asystenta. technologii. Te informacje nie są przechowywane przez Google.

Działania w aplikacji mogą też zbierać metadane aplikacji klienckiej w tych celach:

• monitorowanie wskaźników rozpowszechnienia różnych wersji pakietu SDK;
• Aby mierzyć wykorzystanie funkcji pakietu SDK w aplikacjach.