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.
![](https://developer.android.com/static/guide/app-actions/images/Fitness1.png?authuser=9&hl=de)
START_EXERCISE
mit einer Stimme aufrufen
Anfrage an Assistant senden.![](https://developer.android.com/static/guide/app-actions/images/Fitness3.png?authuser=9&hl=de)
START_EXERCISE
zu beginnen.![](https://developer.android.com/static/guide/app-actions/images/Fitness4-widget.png?authuser=9&hl=de)
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:
- Deklariere die
capability
mit dem ausgewählten BII. - Füge für jedes BII-Feld, das du hinzufügen möchtest, verschachtelte
parameter
-Elemente hinzu.- Wenn Sie
targetClass
odertargetPackage
verwenden, ordnen Sie sie dem Android- Intentextras
mit einem von Ihnen ausgewählten Namen. - Wenn Sie eine Deeplink-URL nutzen, verwenden Sie die benannten Parameter in der Abfrage String der URL-Vorlage.
- Wenn Sie
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.