Mempromosikan add-on kepada pengguna

Developer dapat meningkatkan penemuan add-on mereka dengan mempromosikannya melalui chat dalam panggilan Meet dan melalui fitur berbagi layar Meet.

Chat dalam panggilan

Add-on Google Meet dipromosikan kepada pengguna di chat dalam panggilan Meet secara otomatis saat pesan berisi link yang terkait dengan add-on. Developer tidak perlu melakukan tindakan apa pun untuk mempromosikan add-on dalam chat. Tim peninjau menentukan link mana yang akan dikaitkan dengan add-on, berdasarkan URI panel samping dan asal add-on yang ditetapkan dalam manifes deployment.

Saat pengguna mengirim pesan melalui chat dalam panggilan yang terkait dengan add-on, salah satu dari dua hal berikut akan terjadi:

1. Jika add-on belum diinstal, kartu akan meminta pengguna untuk menginstal add-on.
2. Jika add-on sudah diinstal, tombol akan mengingatkan pengguna untuk membuka add-on.

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 lain.

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

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

• additionalData: Info yang dapat digunakan add-on untuk melakukan inisialisasi. Hanya dapat ditetapkan jika properti startActivityOnOpen benar dan dapat diakses menggunakan ActivityStartingState. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan status mulai aktivitas.

• cloudProjectNumber: Wajib diisi. Nomor project Google Cloud Anda.

• mainStageUrl: URL yang dibuka oleh 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.

• 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.

• startActivityOnOpen: Wajib diisi. Apakah akan segera memulai pengalaman add-on aktivitas di Meet saat pengguna memulai add-on dari banner presentasi. Harus benar jika properti mainStageUrl digunakan.

Menginstal dan mengimpor SDK

Anda dapat mengakses SDK menggunakan npm atau gstatic.

npm install @googleworkspace/meet-addons

import {meet} from '@googleworkspace/meet-addons/meet.addons.screenshare';

<script src="https://www.gstatic.com/meetjs/addons/1.1.0/meet.addons.screenshare.js"></script>

Contoh: Memuat di panel samping tanpa memulai aktivitas

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

<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 di banner akan membuka add-on untuk nomor project cloud tertentu di panel samping. Karena properti startActivityOnOpen ditetapkan ke false, tombol mulai aktivitas dinonaktifkan hingga ActivityStartingState ditetapkan. Untuk mengetahui informasi selengkapnya, lihat Menggunakan status mulai aktivitas.

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

Add-on contoh "Animation" di GitHub menyertakan contoh ini sebagai bagian dari add-on lengkap. Saat halaman indeks aplikasi web yang terkait dengan add-on ditampilkan, pengguna yang menampilkan akan diminta untuk menginstal atau menyiapkan add-on.

Contoh: Memuat di panggung utama

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

<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 Google 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 di banner akan membuka add-on untuk nomor project cloud tertentu di tahap utama. Properti mainStageUrl dimuat, dan properti additionalData digunakan untuk menetapkan status mulai aktivitas add-on. Pengguna lain dalam panggilan akan segera diminta untuk menginstal atau meluncurkan add-on.

Contoh: Memuat di panel samping

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

<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 di banner akan membuka add-on untuk nomor project cloud tertentu di panel samping. Properti sidePanelUrl dimuat, dan properti additionalData digunakan untuk menetapkan status mulai aktivitas add-on. Pengguna lain dalam panggilan akan segera diminta untuk menginstal atau meluncurkan add-on.

Pencocokan asal

Asal yang diberikan di properti mainStageUrl dan properti sidePanelUrl dibandingkan dengan asal di 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 mengetahui informasi selengkapnya, lihat Keamanan add-on.

Topik terkait

• Berkolaborasi menggunakan add-on Meet
• Keamanan add-on