Udostępnianie Asystenta

Użytkownicy telefonów z Androidem mogą poprosić Asystenta Google o udostępnienie treści z aplikacji innemu użytkownikowi, używając polecenia głosowego, np. „OK Google, wyślij to do Janiny”. Siedziba w opcjach systemowych pierwszego użytkownika, Asystent może następnie uwzględnić tekst lub zrzut ekranu z urządzenia w udostępnionych treściach.

Asystent wstawia wybrane zdjęcie do wiadomości, gdy zostanie poproszony.
Rysunek 1. Asystent udostępnia zdjęcie kontaktowi.

Ta metoda udostępniania jest często wystarczająca, ale użytkownicy otrzymujący treści są udostępniane z aplikacji mogą nie być w stanie ponownie jej otworzyć, aby wyświetlić zawartość. Możesz podać Asystent z uporządkowanymi informacjami o bieżących treściach na pierwszym planie według implementować metodę onProvideAssistContent().

Ten proces pomaga zachować strukturę danych podczas udostępniania ich innemu użytkownikowi. Użytkownicy, którzy otrzymują udostępnioną treść aplikacji, mogą mieć precyzyjny link lub otrzymywać treści, a nie w postaci tekstu czy zrzutu ekranu.

Wdróż onProvideAssistContent() w przypadku wszystkich treści, które można udostępniać entity w aplikacji.

Przekazuj treści Asystentowi

W ramach przepływu zadań użytkownika po wywołaniu działania aplikacji należy zaimplementować tylko onProvideAssistContent(). Na przykład w parametrze Proces GET_ITEM_LIST, wdróż metodę na ostatnim ekranie wyświetlanie listy produktów; nie trzeba go wdrażać w przypadku żadnych ekranów podglądu.

Podaj informacje kontekstowe w formie obiektu JSON-LD używając słownika schema.org Pole structuredData dla AssistContent. Poniżej znajduje się fragment kodu, przykład rejestrowania treści kontekstowych:

Kotlin
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()
}
Java
@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();
}

Podaj jak najwięcej danych o poszczególnych elementach typu entity. te pola są wymagane:

  • @type
  • .name
  • .url (wymagany tylko wtedy, gdy treść można zaadresować URL)

Aby dowiedzieć się więcej o korzystaniu z usługi onProvideAssistContent(), zobacz Przewodnik po optymalizacji treści kontekstowych dla Asystenta.