Assistant-Freigabe

Nutzer von Android-Smartphones können Google Assistant bitten, App-Inhalte mit einem anderen Nutzer zu teilen. Dazu geben sie einen Sprachbefehl wie „Hey Google, sende das an Jana“ ein. Basierend auf in den Systemoptionen des ersten Nutzers aktiviert, kann Assistant dann Text aus Bildschirm oder einen Geräte-Screenshot in den geteilten Inhalten.

Diese Methode des Teilens ist oft ausreichend, aber Nutzer, die Inhalte teilen, aus Ihrer App möglicherweise nicht noch einmal aufrufen, um Inhalte anzusehen. Sie können Assistant strukturierte Informationen zu den aktuellen Inhalten im Vordergrund zur Verfügung stellen, indem Sie die Methode onProvideAssistContent() implementieren.

Dieser Prozess hilft, die Struktur der Daten aufrechtzuerhalten, wenn sie an eine andere Person weitergegeben werden Nutzer. Nutzer, die geteilte App-Inhalte erhalten, können dann per Deeplink oder direkt auf die Inhalte zugreifen, anstatt sie als Text oder Screenshot zu erhalten.

onProvideAssistContent() für alle teilbaren Elemente implementieren entity in Ihrer App.

Inhalte für Assistant bereitstellen

Für die endgültige App-Aktivität müssen Sie nur onProvideAssistContent() implementieren im Aufgabenablauf der Nutzenden nach dem Aufrufen der App Action. Implementieren Sie die Methode beispielsweise in einem GET_ITEM_LIST-Vorgang auf dem letzten Bildschirm, auf dem die Artikelliste angezeigt wird. Sie müssen sie nicht für in Bearbeitung befindliche oder Vorschaubildschirme implementieren.

Kontextinformationen als JSON-LD-Objekt angeben unter Verwendung des schema.org-Vokabulars in den Feld structuredData von AssistContent. Das folgende Code-Snippet zeigt ein Beispiel für das Protokollieren von kontextbezogenen Inhalten:

override fun onProvideAssistContent(outContent: AssistContent) {
    super.onProvideAssistContent(outContent)

    // JSON-LD object based on Schema.org structured data
    outContent.structuredData = JSONObject()
            .put("@type", "ItemList")
            .put("name", "My Work items")
            .put("url", "https://my-notes-and-lists.com/lists/12345a")
            .toString()
}
      

@Override
public void onProvideAssistContent(AssistContent outContent) {
  super.onProvideAssistContent(outContent);

  // JSON-LD object based on Schema.org structured data
  outContent.structuredData = new JSONObject()
          .put("@type", "ItemList")
          .put("name", "My Work items")
          .put("url", "https://my-notes-and-lists.com/lists/12345a")
          .toString();
}
      

Geben Sie so viele Daten wie möglich zu jedem entity an. Die folgenden Felder sind Pflichtfelder:

• @type
• .name
• .url (nur erforderlich, wenn der Inhalt URL-adressierbar ist)

Weitere Informationen zur Verwendung von onProvideAssistContent() finden Sie in der Leitfaden zum Optimieren von kontextbezogenen Inhalten für Assistant