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 jikaAddonScreenshareInfo.startActivityOnOpen
bernilai benar (true) dan dapat diakses menggunakanCollaborationStartingState
. 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, sepertihttps://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, sepertihttps://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 jikaAddonScreenshareInfo.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.