Promosikan add-on kepada pengguna melalui berbagi layar

Halaman ini menjelaskan cara mempromosikan add-on kepada pengguna saat membagikan tab layar ke Google Meet dengan menempatkan sejumlah kecil kode pada laman web lain.

Tujuan MeetAddonScreenshare.exposeToMeetWhenScreensharing memungkinkan situs mengirim informasi ke Meet saat tab dibagikan di layar yang dibagikan. Informasi ini digunakan dalam add-on dengan Meet saat pengguna mengklik "Mulai aktivitas" di spanduk presentasi jika mereka memiliki add-on diinstal. Jika pengguna tidak memiliki diinstal saat mereka berbagi layar tab, mereka diminta untuk menginstal add-on.

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

• AddonScreenshareInfo.additionalData: Info yang dapat digunakan add-on untuk melakukan inisialisasi sendiri. Kaleng hanya disetel jika AddonScreenshareInfo.startActivityOnOpen benar dan dapat berupa diakses menggunakan CollaborationStartingState. Untuk mengetahui informasi selengkapnya, lihat Memulai kolaborasi status.

• AddonScreenshareInfo.cloudProjectNumber: Wajib diisi. Nomor project Google Cloud {i>add-on<i}.

• AddonScreenshareInfo.mainStageUrl: URL yang dibuka panggung utama setelah add-on dimulai, seperti https://www.example.com. URL harus berasal dari origin sebagai URL yang ditentukan dalam manifes add-on.

• AddonScreenshareInfo.sidePanelUrl: URL yang akan dibuka panel samping setelah add-on dimulai, seperti https://www.example.com. URL harus berasal dari origin sebagai URL yang ditentukan dalam manifes add-on.

• AddonScreenshareInfo.startActivityOnOpen: Wajib diisi. Apakah akan memulai add-on kolaboratif pengguna di Meet secara langsung saat pengguna memulai {i>add-on <i}dari spanduk presentasi. Harus benar jika AddonScreenshareInfo.mainStageUrl digunakan.

Contoh: Memuat di panggung utama

Dalam contoh kode berikut, pengguna yang layar membagikan halaman web di Meet yang berisi kode berikut akan diminta untuk meluncurkan {i>add-on<i}:

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 tersebut, dia akan melihat banner presentasi di Meet. Mengklik tombol pada banner membuka add-on untuk nomor project cloud yang ditentukan di layar utama. AddonScreenshareInfo.mainStageUrl dimuat, dan AddonScreenshareInfo.additionalData digunakan untuk menyetel kolaborasi yang dimulai status add-on. Pengguna lain dalam panggilan tersebut langsung diminta untuk menginstal atau meluncurkan add-on.

Contoh: Memuat di panel samping

Dalam contoh kode berikut, layar pengguna membagikan halaman kepada {i>add-on <i}yang ingin dimulai di panel samping, daripada tahap utama:

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 tersebut, dia akan melihat banner presentasi di Meet. Mengklik tombol pada banner membuka add-on untuk nomor project cloud yang ditentukan di panel samping. AddonScreenshareInfo.sidePanelUrl dimuat, dan AddonScreenshareInfo.additionalData digunakan untuk menyetel kolaborasi yang dimulai status add-on. Pengguna lain dalam panggilan tersebut langsung diminta untuk menginstal atau meluncurkan add-on.

Contoh: Memuat di panel samping tanpa memulai kolaborasi

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

<script src="https://www.gstatic.com/meetjs/addons/0.7.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 tersebut, dia akan melihat banner presentasi di Meet. Mengklik tombol pada banner membuka add-on untuk nomor project cloud yang ditentukan di panel samping. Sejak AddonScreenshareInfo.startActivityOnOpen disetel ke false, tombol start activity dinonaktifkan hingga CollaborationStartingState disetel. Untuk informasi selengkapnya, lihat Menggunakan kolaborasi dimulai status.

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

Pencocokan origin

Origin yang diberikan di AddonScreenshareInfo.mainStageUrl dan AddonScreenshareInfo.sidePanelUrl dibandingkan dengan origin dalam add-on dari nomor project cloud yang disediakan. Jika semuanya cocok, pengguna diizinkan meluncurkan add-on.

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

Untuk informasi selengkapnya, lihat Add-on keamanan.

Topik terkait

• Menggunakan status awal kolaborasi
• Keamanan add-on