Integrierte Intents für App Actions

Integrierte Intents (BIIs) ermöglichen es Ihrer App, ihre Auftragsausführungsfunktionen gegenüber Google auszudrücken. Durch das Deklarieren von Funktionen in der Datei shortcuts.xml und das Zuordnen von Intent-Parametern zur Auftragsausführung ermöglichen Sie es Google Assistant, Ihre App als Antwort auf eine Abfrage auf einem bestimmten Bildschirm zu starten, damit der Nutzer eine Aufgabe ausführen kann.

Integrierte Intents werden nach App-Kategorien gruppiert. Jede Kategorie steht für eine Reihe allgemeiner Aufgaben, die Nutzer häufig in ihren Apps ausführen möchten. Die vollständige Liste der verfügbaren BIIs, ihrer Parameter und Beispielabfragen, die für Tests verwendet werden können, finden Sie in der Referenz zum integrierten Intent.

Viele BIIs haben spezifische Anforderungen und Empfehlungen für die Bereitstellung. Diese Anforderungen und Empfehlungen tragen dazu bei, dass Ihre App den Nutzern die bestmögliche Erfahrung bietet.

Abbildung 1: Rufen Sie die START_EXERCISE-BII mit einer Sprachnachricht an Assistant auf.
Abbildung 2: Starten Sie die App auf einem bestimmten Bildschirm, um mit der Aufgabe START_EXERCISE zu beginnen.
Abbildung 3: Als Antwort auf eine Abfrage ein Widget anzeigen lassen.

​

BIIs implementieren und Intent-Parameter verarbeiten

Für App Actions deklarieren Sie Funktionen und verarbeiten BII-Parameter in der Datei shortcuts.xml. So implementieren Sie einen BII und verarbeiten seine Parameter:

  1. Deklarieren Sie die capability mit der ausgewählten BII.
  2. Füge für jedes hinzuzufügende BII-Feld verschachtelte parameter-Elemente hinzu.
    1. Wenn Sie targetClass oder targetPackage verwenden, ordnen Sie sie dem Android-Intent extras zu. Verwenden Sie dazu einen von Ihnen ausgewählten Namen.
    2. Bei einer Deeplink-URL nutzen Sie die benannten Parameter im Abfragestring der URL-Vorlage.

Wenn Sie einen BII-Parameter verarbeiten möchten, ordnen Sie ihn dem entsprechenden Parameter eines expliziten Android-Intents in Ihrem capability zu. Anschließend können Sie dessen Wert in Ihrer App verwenden. Ihre Anwendung muss keine BII-Parameter verarbeiten. Versuchen Sie jedoch, Datenfelder zu verarbeiten, die in der Referenz zum integrierten Intent als „Empfohlen“ gekennzeichnet sind.

Sie können mehrere Intent-Auftragsausführungen mit jeweils eigenen empfohlenen Parametern definieren. Google wählt die entsprechende Auftragsausführung anhand der in der Nutzerabfrage und in einem Intent deklarierten Funktionsparameter aus.

Der Intent actions.intent.START_EXERCISE empfiehlt beispielsweise, dass Ihre Anwendung den BII-Parameter exercise.name verarbeitet. Sie können den BII aber auch ohne Parameter in Ihrer App implementieren. Das bietet sich an, wenn Sie Nutzeranfragen ohne den spezifischen Übungsnamen verarbeiten möchten, z. B. „Ask Example App to start Tracking Training“.

Das folgende Snippet hat einen Fallback auf eine Auftragsausführung ohne erforderliche Parameter, wenn die Parameter nicht in der Abfrage des Nutzers enthalten sind:

<?xml version="1.0" encoding="utf-8"?>
<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:targetClass="com.example.myapplication.Activity1"
            android:targetPackage="com.example.myapplication">
            <parameter
                android:name="exercise.name"
                android:key="exerciseType"
                android:required="true"
                />
        </intent>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity2">
        </intent>
    </capability>
</shortcuts>

Google Assistant versucht, dem Nutzer die relevantesten Informationen bereitzustellen, wenn er Parameterwerte an Ihre App zurückgibt. Nutzeranfragen zum Bestellen von Pizza über die mobile App von Example Restaurant enthalten beispielsweise nicht immer einen Standort. Um den Nutzern einen besseren Service bieten zu können, kann Assistant die Breiten- und Längengradwerte des nächstgelegenen Beispielrestaurants angeben.

Außerdem soll Ihre App keine Aktion direkt ausführen, die den tatsächlichen Zustand eines Nutzers ändert (z. B. Geld überweisen, eine Bestellung aufgeben oder eine Nachricht senden), ohne zuvor die Aktion des Nutzers bestätigt zu haben.

Begriffsbestimmung

Argumente, die über <url-parameter> oder Intent-Extras an Ihre Anwendung übergeben werden, identifizieren das Element, das Sie dem Nutzer anzeigen möchten, möglicherweise nicht eindeutig. Verwenden Sie in diesem Fall den Argumentwert als Suchargument und leiten Sie den Nutzer zur Suchseite der App weiter. Er kann das Element eindeutig machen und das richtige Element auswählen.

Wenn die Abfrage eines Nutzers beispielsweise „Order from Example Restaurant“ für die BII ORDER_MENU_ITEM lautet, können Sie ihm eine Liste von Restaurants präsentieren, deren Namen mit dem Begriff "Example Restaurant" übereinstimmen.

Unterstützte Sprache und Region

Die von den einzelnen App Action-BII unterstützten Sprachen für Entwicklung und Tests sind in der Referenz zum integrierten Intent aufgeführt. Einige BIIs unterstützen unterschiedliche Sprachen für Entwicklertests und Nutzerauslöser über Assistant.