Halaman ini diterjemahkan oleh Cloud Translation API.

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 sejumlah kecil kode di halaman web lain.

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

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

AddonScreenshareInfo.additionalData: Info yang dapat digunakan add-on untuk melakukan inisialisasi sendiri. Hanya dapat ditetapkan jika AddonScreenshareInfo.startActivityOnOpen bernilai benar (true) dan dapat diakses menggunakan CollaborationStartingState. Untuk mengetahui informasi selengkapnya, lihat Menggunakan status awal kolaborasi.
AddonScreenshareInfo.cloudProjectNumber: Wajib. Nomor add-on project Google Cloud.
AddonScreenshareInfo.mainStageUrl: URL yang dibuka panggung utama setelah add-on dimulai, seperti https://www.example.com. URL harus berasal dari origin yang sama dengan URL yang ditentukan dalam manifes add-on.
AddonScreenshareInfo.sidePanelUrl: URL yang dibuka panel samping setelah add-on dimulai, seperti https://www.example.com. URL harus berasal dari origin yang sama dengan URL yang ditentukan dalam manifes add-on.
AddonScreenshareInfo.startActivityOnOpen: Wajib. Apakah akan memulai pengalaman add-on kolaboratif di Meet langsung saat pengguna memulai add-on dari banner presentasi. Harus benar jika AddonScreenshareInfo.mainStageUrl digunakan.

Contoh: Memuat di panggung utama

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

<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, mereka akan melihat banner presentasi di Meet. Mengklik tombol pada banner akan membuka add-on untuk nomor project cloud yang ditentukan di tahap utama. AddonScreenshareInfo.mainStageUrl dimuat, dan AddonScreenshareInfo.additionalData digunakan untuk menetapkan status awal kolaborasi add-on. Pengguna lain dalam panggilan 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.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, 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 akan segera diminta untuk menginstal atau meluncurkan add-on.

Contoh: Memuat di panel samping tanpa memulai kolaborasi

Pada 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 memulai kolaborasi 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, 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 disetel ke salah, tombol mulai aktivitas dinonaktifkan hingga CollaborationStartingState disetel. Untuk mengetahui 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 disediakan di AddonScreenshareInfo.mainStageUrl dan AddonScreenshareInfo.sidePanelUrl dibandingkan dengan origin dalam manifes add-on dari nomor project cloud yang diberikan. Jika semuanya cocok, pengguna diizinkan untuk meluncurkan add-on.

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

Untuk informasi selengkapnya, lihat Keamanan add-on.

Promosikan add-on kepada pengguna melalui berbagi layar

Contoh: Memuat di panggung utama

Contoh: Memuat di panel samping

Contoh: Memuat di panel samping tanpa memulai kolaborasi

Pencocokan origin

Topik terkait