Integrierte Intents für App Actions

Mit integrierten Intents (BIIs) kann Ihre App die Funktionen zur Auftragsausführung nutzen an Google senden. Durch das Deklarieren von Funktionen in der Datei shortcuts.xml und der Auftragsausführung Intent-Parameter zuordnen, Google Assistant die App als Reaktion auf einen bestimmten Bildschirm starten damit Nutzende eine Aufgabe erledigen können.

Integrierte Intents werden nach App-Kategorien gruppiert. Jede Kategorie stehen für eine Reihe allgemeiner Aufgaben, die Nutzende häufig auf ihrer Apps. Die vollständige Liste der verfügbaren BIIs, deren Parameter und ein Beispiel Abfragen, die für Tests geeignet sind, finden Sie in der Referenz zu integrierten Intents.

Viele BIIs haben spezifische Bereitstellungsanforderungen Empfehlungen. Diese Anforderungen und Empfehlungen tragen dazu bei, die bestmögliche Nutzererfahrung bieten.

<ph type="x-smartling-placeholder">
</ph>
Abbildung 1: BII START_EXERCISE mit einer Stimme aufrufen Anfrage an Assistant senden.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 2: App auf einem bestimmten Bildschirm starten um mit der Aufgabe START_EXERCISE zu beginnen.
<ph type="x-smartling-placeholder">
</ph>
Abbildung 3: Hiermit wird ein Widget als Antwort auf eine Suchanfrage angezeigt.

​

BIIs implementieren und Intent-Parameter verarbeiten

Bei App Actions deklarieren Sie Funktionen und verarbeiten BII-Parameter. in der Datei shortcuts.xml. Implementierung eines BII und Umgang mit Parameter verwenden, führen Sie diese Schritte aus:

  1. Deklariere die capability mit dem ausgewählten BII.
  2. Füge für jedes BII-Feld, das du hinzufügen möchtest, verschachtelte parameter-Elemente hinzu.
    1. Wenn Sie targetClass oder targetPackage verwenden, ordnen Sie sie dem Android- Intent extras mit einem von Ihnen ausgewählten Namen.
    2. Wenn Sie eine Deeplink-URL nutzen, verwenden Sie die benannten Parameter in der Abfrage String der URL-Vorlage.

Um einen BII-Parameter zu verarbeiten, ordne den BII-Parameter dem entsprechenden Parameter eines expliziten Android-Intents in capability. Anschließend können Sie den Wert in Ihrer App verwenden. Ihre App muss keine BII-Parameter. Versuchen Sie jedoch, Datenfelder zu bearbeiten, die als „Empfohlen“ gekennzeichnet sind. finden Sie in der Referenz zum integrierten Intent.

Sie können mehrere Intent-Auftragsausführungen mit jeweils eigenen empfohlenen Parameter. Google wählt die entsprechende Auftragsausführung anhand der Funktionsparameter, die er anhand der Suchanfrage des Nutzers identifiziert, sowie den deklarierten in einem Intent.

Beispiel: Der actions.intent.START_EXERCISE Intent empfiehlt, dass Ihre App den BII-Parameter exercise.name verarbeitet, Sie den BII ohne Parameter in Ihrer App implementieren können. Dies ist zum Beispiel nützlich, wenn Sie Nutzeranfragen ohne den spezifischen Trainingsname, wie „Ask Example App, um mit der Aufzeichnung des Trainings zu beginnen“

Die Das folgende Snippet hat ein Fallback für eine Auftragsausführung ohne erforderliche Parameter Wenn die Parameter nicht in der Suchanfrage 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, Ihnen möglichst relevante Informationen zu liefern wenn Parameterwerte an Ihre App zurückgegeben werden. Beispiel: Nutzeranfragen für die Pizzabestellung über die mobile App des Beispielrestaurants enthalten nicht immer eine Standort. Im Interesse der Nutzer kann Assistant den Breitengrad angeben. und Längengradwerte des Beispielrestaurants, das dieser App am nächsten ist.

Außerdem möchten Sie nicht, dass Ihre App eine Aktion, die den tatsächlichen Status eines Nutzers ändert (z. B. Geld senden, eine Bestellung aufgeben oder eine Nachricht senden), ohne zuvor die Aktion mit den Nutzenden.

Begriffsklärung

Argumente, die über <url-parameter> oder Intent-Extras an die Anwendung übergeben werden, sind möglicherweise nicht eindeutig das Element identifiziert, das Sie dem Nutzer anzeigen möchten. In diesem Fall Argumentwert als Suchargument verwenden und den Nutzer zur Suche weiterleiten Seite der App. Er kann den Artikel unterscheiden und den richtigen Artikel auswählen.

Lautet die Suchanfrage eines Nutzers beispielsweise „Bestellung beim Beispielrestaurant“ für die BII ORDER_MENU_ITEM, du kannst dem Nutzer eine Liste mit Restaurants, deren Namen dem Begriff "Example Restaurant" entsprechen.

Unterstützte Sprachen und Sprachen

Die Sprachen, die von jedem App Action-BII für Entwicklung und Tests unterstützt werden sind in der Referenz zu integrierten Intents aufgeführt. Einige BIIs haben unterschiedliche Sprachunterstützung für Entwicklertests und zum Auslösen von Nutzeraktionen über Assistant.