Tingkatkan pengalaman pengguna secara keseluruhan dengan mengikuti panduan desain add-on Google Meet ini.
Praktik terbaik otorisasi
Sebaiknya gunakan praktik terbaik berikut untuk add-on Google Meet yang memerlukan autentikasi atau otorisasi.
Menggunakan Login dengan Google
Banyak pengguna add-on Google Workspace sudah login ke Google sebelum bergabung ke rapat. Oleh karena itu, menyediakan Google One Tap sebagai opsi dapat menghemat beberapa klik pengguna saat melalui alur login. Untuk mengetahui informasi selengkapnya, lihat Mengelola metode login untuk add-on Anda.
Membuka halaman login pihak ketiga di jendela baru
Selain login Google, aplikasi Anda dapat menawarkan mekanisme login tambahan. Jika demikian, gunakan jendela dialog, bukan membuka halaman login di tab baru. Dengan cara ini, pengguna masih dapat melihat dan kembali ke panggilan Meet, serta akan melakukan lebih sedikit klik secara keseluruhan.
Meminta cakupan dengan benar untuk Google API
Jika add-on Meet Anda memanggil Google API, maka Anda harus memberikan daftar lengkap cakupan OAuth yang diperlukan oleh add-on Anda. Hal ini dilakukan di halaman Konfigurasi Aplikasi Google Workspace Marketplace. Setelah menambahkan cakupan ini, pengguna akan melihat perintah saat menginstal add-on Meet Anda yang memberi tahu pengguna jenis data yang mereka izinkan untuk diakses oleh aplikasi Anda.
Sebelum memublikasikan add-on, Anda juga harus menyiapkan layar izin OAuth. Hal ini mengharuskan Anda menambahkan cakupan otorisasi yang sama persis dari Konfigurasi Aplikasi Google Workspace Marketplace. Mengonfigurasi layar izin OAuth juga mengharuskan Anda menetapkan informasi branding, kebijakan privasi, dan persyaratan layanan yang ditampilkan saat cakupan diminta. Untuk memublikasikan secara publik, semua informasi ini harus dikirimkan untuk diverifikasi.
Saat menulis kode untuk memanggil Google Workspace API, mengikuti Panduan Memulai JavaScript adalah cara termudah untuk memulai. Pendekatan ini mematuhi praktik terbaik untuk menggunakan Login dengan Google dan jendela dialog. Perhatikan bahwa menginisialisasi token klien di JavaScript mengharuskan Anda meminta cakupan yang sebenarnya digunakan aplikasi saat runtime secara terpisah. Untuk pengalaman pengguna terbaik, cakupan yang diminta ini harus cocok dengan cakupan di halaman Konfigurasi Aplikasi Google Workspace Marketplace. Redundansi ini memberikan penggantian untuk menangani kasus saat seorang pengguna telah mencabut cakupan.
Praktik terbaik pemeliharaan
Praktik terbaik berikut adalah untuk menulis aplikasi web yang dapat dipelihara, tetapi sangat penting saat menulis add-on Meet.
Menggunakan Google Meet add-ons SDK versi terbaru
Meet add-ons SDK diperbarui secara rutin. SDK ini mematuhi pembuatan versi semantik. Untuk menemukan versi terbaru:
- Saat menggunakan gstatic: Versi SDK terbaru terdapat dalam URL gstatic yang ditemukan dalam petunjuk penggunaan SDK.
- Saat menggunakan npm: Jalankan
npm update @googleworkspace/meet-add-onsdari dalam direktori yang berisipackage.jsonuntuk situs yang menghosting add-on Meet Anda.
Membuat project Google Cloud staging
Setelah add-on Google Meet Anda dipublikasikan di Google Workspace Marketplace, deployment baru add-on Google Meet Anda akan langsung tersedia untuk pengguna Meet. Pengguna akan melihat update ini segera setelah mereka mengosongkan cache atau cache berakhir masa berlakunya. Oleh karena itu, sebaiknya jangan kirim perubahan ke situs produksi Anda hingga perubahan tersebut diuji secara menyeluruh.
Untuk menghindari deployment langsung ke produksi, sebaiknya buat project Google Cloud terpisah yang dipublikasikan secara pribadi ke organisasi Anda. Project Cloud ini akan menghosting lingkungan staging dan pengembangan untuk add-on Meet Anda. Akses untuk project Cloud ini harus dibatasi untuk tim yang lebih kecil yang langsung mengerjakan pengembangan add-on Anda.
Untuk membuat lingkungan alternatif ini untuk add-on Anda, pertama-tama Anda harus menghosting lingkungan alternatif aplikasi web yang berisi add-on Anda, di domain yang Anda miliki. Kemudian, Anda dapat membuat lingkungan alternatif untuk add-on Meet dengan menambahkan deployment tambahan ke project Google Cloud staging Anda. Deployment baru ini harus memiliki manifes yang mengarah ke lingkungan alternatif aplikasi web Anda. Kemudian, sebaiknya instal setiap lingkungan add-on sebagai berikut:
- Staging: Publikasikan versi staging secara pribadi sehingga siapa pun di organisasi Anda dapat membantu pengujian.
- Pengembangan: Klik Instal di kolom Tindakan untuk menginstal versi pengembangan add-on Meet hanya ke akun Anda.
Menulis pengujian
Sebelum men-deploy add-on Meet ke lingkungan pengembangan, sebaiknya tulis pengujian unit. Pengujian unit Anda harus mencakup:
- Menyediakan mock untuk Meet add-ons SDK, lalu memverifikasi bahwa add-on Meet memanggil fungsi SDK seperti yang diharapkan.
- Pengujian unit semua fungsi yang tidak terkait SDK dari add-on Anda dengan framework pengujian web pilihan Anda.
Praktik terbaik pengalaman pengguna
Praktik terbaik berikut membantu membuat add-on Meet lebih intuitif dan disempurnakan.
Mengelola semua status awal di panel samping
Sebaiknya siapkan add-on Anda berdasarkan
tindakan pengguna yang dilakukan di panel samping.
Hal ini dilakukan dengan menetapkan status awal aktivitas
state di
JavaScript. Semua data yang masuk ke
ActivityStartingState
harus ditetapkan oleh inisiator add-on (biasanya
host rapat) dalam panel samping. Anda dapat menganggap tampilan pertama panel samping sebagai formulir yang mengontrol penyiapan add-on Anda.
Menutup panel samping saat tidak digunakan
Setelah memulai aktivitas dengan memanggil metode
startActivity(), Anda hanya boleh membuka panel
samping jika merupakan bagian penting
dari pengalaman pengguna untuk add-on Google Meet Anda. Anda dapat menutup
panel samping setelah tahap utama
dibuka dengan memanggil
unloadSidePanel()
metode.
Mempromosikan add-on Meet Anda melalui berbagi layar
Add-on Meet menawarkan pengalaman yang lebih kaya daripada berbagi layar. Namun, banyak pengguna terbiasa menggunakan fitur berbagi layar Meet. Jika pengguna membagikan tab yang menampilkan situs yang menghosting add-on Meet Anda, Meet dapat dikonfigurasi untuk menampilkan banner kepada semua peserta panggilan yang meminta mereka untuk menginstal atau menggunakan add-on Meet yang sesuai. Untuk mengetahui informasi selengkapnya, lihat mempromosikan add-on Anda melalui berbagi layar.
Panduan desain logo
Ikuti panduan ini saat mendesain logo khusus Meet agar terlihat terbaik sekarang dan di masa mendatang:
Gunakan format file PNG, berukuran 256x256 piksel.
Gunakan transparansi.
Verifikasi logo mode gelap Anda terlihat bagus dalam mode gelap menggunakan alat developer untuk add-on Meet.
Verifikasi logo Anda (dan aset visual lainnya) terlihat bagus dalam mode kontras tinggi menggunakan pemeriksa kontras seperti Contrast Checker by Web Accessibility In Mind (WebAIM).
Patuhi persyaratan grafis untuk integrasi aplikasi tertentu.
Jangan sertakan padding dalam gambar Anda. Perluas gambar ke batas file Anda.