Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les utilisateurs de téléphones Android peuvent demander à l'Assistant Google de partager du contenu d'application avec un autre utilisateur à l'aide d'une commande vocale telle que Hey Google, envoie ça à Jeanne. Basés
sur les options système du premier utilisateur, l'Assistant peut ensuite intégrer du texte
l'écran ou une capture d'écran
d'un appareil dans le contenu partagé.
Figure 1. L'Assistant partage une photo avec un contact.
Bien souvent, cette méthode de partage suffit, mais les utilisateurs qui reçoivent du contenu partagé depuis votre application n'ouvriront peut-être pas votre application à nouveau pour afficher le contenu envoyé. Vous pouvez fournir à l'Assistant des informations structurées sur le contenu actuel de premier plan en implémentant la méthode onProvideAssistContent().
Ce processus permet de maintenir la structure des données lors de leur partage avec un autre utilisateur. Les utilisateurs qui reçoivent du contenu d'application partagé peuvent ensuite recevoir un lien profond ou recevoir le contenu directement, plutôt que sous forme de texte ou de capture d'écran.
Implémentez onProvideAssistContent() pour tout élément partageable
entity dans votre application.
Fournir des contenus à l'Assistant
Il vous suffit d'implémenter onProvideAssistContent() pour l'activité finale de l'application.
dans le flux de tâches de l'utilisateur après avoir appelé l'action dans l'application. Par exemple, dans un
Flux GET_ITEM_LIST, implémentez la méthode dans l'écran final.
afficher la liste des articles ; vous n'avez pas besoin de l'implémenter
pour les opérations en cours ou
des écrans d'aperçu.
Fournissez des informations contextuelles sous forme d'objet JSON-LDà l'aide du vocabulaire schema.org dans le champ structuredData de AssistContent. L'extrait de code suivant montre un exemple de journalisation de contenu contextuel :
Kotlin
overridefunonProvideAssistContent(outContent:AssistContent){super.onProvideAssistContent(outContent)// JSON-LD object based on Schema.org structured dataoutContent.structuredData=JSONObject().put("@type","ItemList").put("name","My Work items").put("url","https://my-notes-and-lists.com/lists/12345a").toString()}
Java
@OverridepublicvoidonProvideAssistContent(AssistContentoutContent){super.onProvideAssistContent(outContent);// JSON-LD object based on Schema.org structured dataoutContent.structuredData=newJSONObject().put("@type","ItemList").put("name","My Work items").put("url","https://my-notes-and-lists.com/lists/12345a").toString();}
Fournissez autant de données que possible sur chaque entity. La
Les champs suivants sont obligatoires:
@type
.name
.url (obligatoire uniquement si le contenu est adressable par URL)
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/08 (UTC)."],[],[],null,["# Assistant sharing\n\nUsers on Android phones can ask Google Assistant to share app content with\nanother user using a voice command like *\"Hey Google, send this to Jane.\"* Based\non the first user's system options, Assistant can then incorporate text from\nthe screen or a device screenshot in the shared content.\n**Figure 1.** Assistant shares a photo with a contact.\n\nThis method of sharing is often sufficient, but users who receive content shared\nfrom your app might not re-enter the app to view content. You can provide\nAssistant with structured information about the current foreground content by\nimplementing the [`onProvideAssistContent()`](/reference/android/app/Activity#onProvideAssistContent(android.app.assist.AssistContent)) method.\n\nThis process helps maintain the structure of data as it's shared to another\nuser. Users who receive shared app content can then be deep linked or receive\ncontent directly, instead of as text or as a screenshot.\n\nImplement `onProvideAssistContent()` for any sharable\n[`entity`](/guide/app-actions/legacy/action-schema#entity) in your app.\n\nProvide content to Assistant\n----------------------------\n\nYou only need to implement `onProvideAssistContent()` for the final app activity\nin the user's task flow after invoking the App Action. For example, in a\n`GET_ITEM_LIST` flow, implement the method in the final screen\nshowing the item list; you don't need to implement it for any in-progress or\npreview screens.\n\nProvide contextual information as a [JSON-LD](//json-ld.org/) object\n[using schema.org vocabulary](https://schema.org/docs/documents.html) in the\n`structuredData` field of [`AssistContent`](/reference/android/app/assist/AssistContent). The following code snippet shows\nan example of logging contextual content:\nKotlin \n\n```kotlin\noverride fun onProvideAssistContent(outContent: AssistContent) {\n super.onProvideAssistContent(outContent)\n\n // JSON-LD object based on Schema.org structured data\n outContent.structuredData = JSONObject()\n .put(\"@type\", \"ItemList\")\n .put(\"name\", \"My Work items\")\n .put(\"url\", \"https://my-notes-and-lists.com/lists/12345a\")\n .toString()\n}\n \n```\nJava \n\n```java\n@Override\npublic void onProvideAssistContent(AssistContent outContent) {\n super.onProvideAssistContent(outContent);\n\n // JSON-LD object based on Schema.org structured data\n outContent.structuredData = new JSONObject()\n .put(\"@type\", \"ItemList\")\n .put(\"name\", \"My Work items\")\n .put(\"url\", \"https://my-notes-and-lists.com/lists/12345a\")\n .toString();\n}\n \n```\n\nProvide as much data as possible about each `entity`. The\nfollowing fields are required:\n\n- `@type`\n- `.name`\n- `.url` (only required if the content is URL-addressable)\n\nTo learn more about using `onProvideAssistContent()`, see the\n[Optimizing Contextual Content for the Assistant](/training/articles/assistant) guide."]]