Berbagi Asisten

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

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.

Sebaiknya 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 CREATE_MONEY_TRANSFER, Anda akan menerapkan metode tersebut di layar akhir yang menampilkan tanda terima; Anda tidak perlu menerapkannya untuk layar pratinjau atau yang sedang berlangsung.

Memberikan 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();
}
      

Meskipun kami merekomendasikan menyediakan data sebanyak mungkin tentang setiap entity, kami mengharuskan kolom berikut:

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

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