Promosikan add-on kepada pengguna melalui berbagi layar

Mempromosikan add-on melalui berbagi layar.

Halaman ini menjelaskan cara mempromosikan add-on kepada pengguna saat berbagi layar tab dengan Google Meet dengan menempatkan sedikit kode di halaman web lainnya.

Metode MeetAddonScreenshare.exposeToMeetWhenScreensharing memungkinkan situs mengirim informasi ke Meet saat tabnya dibagikan melalui layar. Informasi ini digunakan dalam pengalaman add-on dengan Meet saat pengguna mengklik "Mulai aktivitas" pada banner presentasi jika mereka telah menginstal add-on. Jika belum menginstal add-on saat berbagi tab melalui layar, pengguna akan diminta untuk menginstal add-on.

Objek AddonScreenshareInfo berisi lima kolom yang dapat ditambahkan berdasarkan kasus penggunaan:

Contoh: Pemuatan di stage utama

Dalam contoh kode berikut, pengguna yang membagikan halaman web di Meet yang berisi kode berikut akan diminta untuk meluncurkan add-on:

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Ganti kode berikut:

  • CLOUD_PROJECT_NUMBER: String. Nomor project cloud Anda.
  • MAIN_STAGE_URL: String. URL untuk panggung utama.

Saat pengguna di layar panggilan Meet membagikan halaman, mereka akan melihat banner presentasi di Meet. Mengklik tombol pada banner akan membuka add-on untuk nomor project cloud yang ditentukan pada tahap utama. AddonScreenshareInfo.mainStageUrl dimuat, dan AddonScreenshareInfo.additionalData digunakan untuk menetapkan status awal kolaborasi add-on. Pengguna lain dalam panggilan tersebut akan segera diminta untuk menginstal atau meluncurkan add-on.

Contoh: Memuat di panel samping

Dalam contoh kode berikut, layar pengguna berbagi halaman dengan add-on yang ingin dimulai di panel samping, bukan tahap utama:

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

Ganti kode berikut:

  • CLOUD_PROJECT_NUMBER: String. Nomor project cloud Anda.
  • SIDE_PANEL_URL: String. URL untuk panel samping.

Saat pengguna di layar panggilan Meet membagikan halaman, mereka akan melihat banner presentasi di Meet. Mengklik tombol pada banner akan membuka add-on untuk nomor project cloud yang ditentukan di panel samping. AddonScreenshareInfo.sidePanelUrl dimuat, dan AddonScreenshareInfo.additionalData digunakan untuk menetapkan status awal kolaborasi add-on. Pengguna lain dalam panggilan tersebut akan segera diminta untuk menginstal atau meluncurkan add-on.

Contoh: Memuat di panel samping tanpa memulai kolaborasi

Dalam contoh kode berikut, layar pengguna membagikan halaman dengan add-on yang harus menyesuaikan izin resource sebelum aktivitas kolaborasi dapat dimulai. Karena persyaratan ini, add-on harus dimulai di panel samping, tanpa kolaborasi dimulai untuk semua orang.

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

Ganti kode berikut:

  • CLOUD_PROJECT_NUMBER: String. Nomor project cloud Anda.
  • SIDE_PANEL_URL: String. URL untuk panel samping.

Saat pengguna di layar panggilan Meet membagikan halaman, mereka akan melihat banner presentasi di Meet. Mengklik tombol pada banner akan membuka add-on untuk nomor project cloud yang ditentukan di panel samping. Karena AddonScreenshareInfo.startActivityOnOpen ditetapkan ke salah (false), tombol mulai aktivitas dinonaktifkan hingga CollaborationStartingState ditetapkan. Untuk informasi selengkapnya, lihat Menggunakan status awal kolaborasi.

Setelah aktivitas dimulai, pengguna lain dalam panggilan akan diminta untuk meluncurkan atau menginstal add-on.

Pencocokan origin

Origin yang diberikan di AddonScreenshareInfo.mainStageUrl dan AddonScreenshareInfo.sidePanelUrl dibandingkan dengan origin dalam manifes add-on nomor project cloud yang disediakan. Jika semuanya sesuai, pengguna diizinkan untuk meluncurkan {i>add-on<i}.

Selain itu, asal situs yang memulai berbagi layar harus dicantumkan di kolom addOnOrigins dalam manifes add-on.

Untuk informasi selengkapnya, lihat Keamanan add-on.