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 jikaAddonScreenshareInfo.startActivityOnOpen
benar dan dapat berupa diakses menggunakanCollaborationStartingState
. 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, sepertihttps://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, sepertihttps://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 jikaAddonScreenshareInfo.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.9.1/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.9.1/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.9.1/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.