Funktionen zu Verknüpfungen hinzufügen

Mit Funktionen in shortcuts.xml können Sie die Arten von Aktionen deklarieren, die Nutzer ausführen können um Ihre App zu starten und eine bestimmte Aufgabe direkt auszuführen.

Google Assistant App Actions nutzen beispielsweise Funktionen, damit Entwickler Sie können In-App-Funktionen auf integrierte Intents (BIIs) ausweiten, sodass Nutzer und diese Funktionen per Sprachbefehl steuern. Eine Capability besteht aus den der Aktion und ein intent, das auf das Ziel in Ihrer App ausgerichtet ist, den Nutzerabsicht auflöst.

Definieren Sie Funktionen in der Datei „shortcuts.xml“

Sie definieren capability-Elemente in einer shortcuts.xml-Ressourcendatei in Ihrem Android-App-Entwicklungsprojekt Führen Sie zum Definieren eines capability-Elements die Methode Folgendes:

1. Erstellen Sie eine shortcuts.xml-Ressource. Folgen Sie dazu der Anleitung unter Erstellen statische Tastenkombinationen.

2. Nehmen Sie die folgenden erforderlichen Informationen in Ihre Fähigkeiten auf:

   • Funktionsname:Aktion, die Ihre App unterstützen soll. Weitere Informationen finden Sie unter der Komponentendokumentation für die Funktion, die die Funktionen erfordert Definitionen. Für sprachgesteuerte App Actions-Befehle wird der BII Action ID verwendet für Funktionsnamen, die Sie in der BII-Referenz finden. Beispiel: Der BII GET_THING listet seine Action ID als actions.intent.GET_THING auf.

   • App-Ziel:Das Ziel in Ihrer App, an dem die Aktion gestartet wird. die Anforderung der Nutzenden erfüllen. App-Ziele mit intent-Elementen definieren in capability verschachtelt.

   • Parameterzuordnungen: Jeder intent kann Parameter enthalten, die werden als extra-Daten des Intents übergeben. Beispiel: Jeder App Actions-BII enthält Felder, die Informationen darstellen, die Benutzer häufig in Abfragen angeben, die den BII auslösen.

Das folgende Beispiel zeigt eine Funktionsdefinition in shortcuts.xml. für actions.intent.START_EXERCISE, einen BII, mit dem Nutzer gesprochene Inhalte verwenden können Befehle mit Assistant, um ein Training in einer Fitness-App zu starten:

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

Im vorherigen Beispiel bezieht sich das <capability>-Attribut android:name auf den BII START_EXERCISE. Wenn ein Nutzer diesen BII aufruft, indem er Assistant fragt: „Hey Google, starte einen Lauf in ExampleApp“ angezeigt wird, führt Assistant die Nutzeranfrage mit Informationen, die im verschachtelten intent-Element angegeben sind. Der intent in diesem Beispiel definiert die folgenden Details:

• Mit android:targetPackage wird das Zielanwendungspaket dafür festgelegt. die Nutzerabsicht verstehen.
• Das Feld android:targetClass gibt die Zielaktivität an: com.example.sampleApp.ExerciseActivity.
• Der Intent „parameter“ deklariert die Unterstützung eines BII-Parameters exercise.name und wie der Parameterwert übergeben wird (erfasst) vom Nutzer – als zusätzliche Daten in intent.

Verknüpfungen mit einer Funktion verknüpfen

Nachdem Sie eine Funktion definiert haben, können Sie ihre Funktionalität erweitern, indem Sie statische oder dynamische Tastenkombinationen ein. Verknüpfungen mit einem capability hängt von der implementierten Funktion und den Wörtern ab, Anforderung des Nutzers. Beispiel: Wenn ein Nutzer einen Lauf in deinem Fitness-Tracking startet indem du Assistant sagst: „Hey Google, starte einen Lauf in ExampleApp.“ Assistent kann eine Tastenkombination verwenden, um eine Instanz einer capability zu starten, die eine gültige Übungsentität „Laufen“ für den Parameter exercise.name.

Weitere Informationen zum Verknüpfen von Verknüpfungen mit App Actions finden Sie unter App Actions Übersicht über Aktionen