Berbagi Asisten

Pengguna di ponsel Android dapat meminta Asisten Google untuk membagikan konten aplikasi kepada pengguna lain menggunakan perintah suara seperti "Ok Google, kirim ini kepada Jihan". Berdasarkan opsi sistem pengguna pertama, Asisten kemudian dapat menggabungkan teks dari layar atau screenshot perangkat dalam konten yang dibagikan.

Asisten akan menyisipkan foto yang dipilih ke pesan saat
            diminta.
Gambar 1. Asisten membagikan foto ke kontak.

Metode berbagi ini sering kali cukup, tetapi pengguna yang menerima konten yang dibagikan dari aplikasi Anda mungkin tidak masuk kembali ke aplikasi untuk melihat konten. Anda dapat memberikan informasi terstruktur kepada Asisten tentang konten latar depan saat ini dengan mengimplementasikan metode onProvideAssistContent().

Proses ini membantu mempertahankan struktur data saat dibagikan kepada pengguna lain. Pengguna yang menerima konten aplikasi bersama kemudian dapat memiliki deep link atau menerima konten secara langsung, bukan sebagai teks atau screenshot.

Terapkan onProvideAssistContent() untuk setiap entity yang dapat dibagikan di aplikasi Anda.

Menyediakan konten ke Asisten

Anda hanya perlu menerapkan onProvideAssistContent() untuk aktivitas aplikasi akhir dalam alur tugas pengguna setelah memanggil Action Aplikasi. Misalnya, dalam alur GET_ITEM_LIST, terapkan metode tersebut di layar akhir yang menampilkan daftar item; Anda tidak perlu menerapkannya untuk layar pratinjau atau yang sedang berlangsung.

Berikan informasi kontekstual sebagai objek JSON-LD menggunakan kosakata schema.org dalam kolom structuredData dari AssistContent. Cuplikan kode berikut menunjukkan contoh logging konten kontekstual:

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

    // JSON-LD object based on Schema.org structured data
    outContent.structuredData = JSONObject()
            .put("@type", "MenuItem")
            .put("name", "Blueberry Crisp Iced Signature Latte")
            .put("url", "https://mysite.com/menuitems/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", "MenuItem")
          .put("name", "Blueberry Crisp Iced Signature Latte")
          .put("url", "https://mysite.com/menuitems/12345a")
          .toString();
}
      

Berikan data sebanyak mungkin tentang setiap entity. Kolom berikut diperlukan:

  • @type
  • .name
  • .url (hanya diperlukan jika konten dapat dialamatkan URL)

Untuk mempelajari lebih lanjut cara menggunakan onProvideAssistContent(), lihat panduan Mengoptimalkan Konten Kontekstual untuk Asisten.