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.

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 CREATE_MONEY_TRANSFER, terapkan metode tersebut di layar akhir yang menampilkan tanda terima; 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.