Memecahkan masalah dan memperbaiki error add-on Meet

Panduan ini memberikan petunjuk tentang cara mengatasi error tertentu pada Google Meet add-ons SDK yang mungkin Anda temui saat membuat dan menguji add-on Meet.

Untuk mendapatkan detail tentang error, gunakan objek MeetAddonError. Objek ini berisi properti errorType yang menentukan jenis error.

Jenis error

Berikut adalah jenis error yang dihasilkan saat Meet add-ons SDK menampilkan error, beserta penjelasan tentang cara menafsirkannya dan panduan tentang tindakan yang harus dilakukan saat Anda mendapatkannya.

Error Pesan error Tindakan
ActivityIsOngoing Tidak dapat melakukan operasi saat aktivitas sedang berlangsung. Pastikan aktivitas tidak sedang berlangsung.
ActivityStartingStateEmpty Status awal aktivitas kosong. Objek ActivityStartingState diberikan, tetapi tidak berisi atribut apa pun.
ActivityStartingStateMissingAttributes Status awal aktivitas tidak berisi atribut yang dikenali. Pastikan objek ActivityStartingState berisi setidaknya salah satu atribut berikut: mainStageUrl, sidePanelUrl, atau additionalData.
ActivityStartingStateUnrecognizedAttributes Status awal aktivitas berisi atribut yang tidak dikenali. Pastikan objek ActivityStartingState hanya memiliki atribut berikut: mainStageUrl, sidePanelUrl, atau additionalData.
AddonSessionAlreadyCreated Sesi add-on sudah dibuat. Hanya buat instance AddonSession satu kali.
AddonStartingStateMissingAttributes Status awal add-on tidak berisi atribut yang dikenali. Pastikan objek AddonStartingState berisi setidaknya salah satu atribut berikut: sidePanelUrl, additionalData.
AddonStartingStateUnrecognizedAttributes Status awal add-on berisi atribut yang tidak dikenali. Pastikan objek AddonStartingState hanya memiliki atribut berikut: sidePanelUrl, additionalData.
ArgumentNullError Nilai objek yang diberikan adalah null, padahal nilai diharapkan ada. Pastikan Anda meneruskan nilai dengan jenis yang diharapkan untuk argumen.
ArgumentTypeError Jenis objek yang diberikan tidak cocok dengan jenis yang diharapkan. Pastikan jenis argumen yang diberikan cocok dengan jenis yang diharapkan.
DestinationNotReady Frame penerima tidak terhubung menggunakan Meet add-ons SDK dan tidak dapat menerima notifikasi. Pastikan frame tujuan terhubung sebelum mengirim pesan ke frame tersebut.
InternalError Terjadi error internal Meet. Tidak ada informasi lebih lanjut yang tersedia.
InvalidActivityStartingState URL iframe ActivityStartingState tidak cocok dengan asal URL yang diberikan dalam manifes add-on. Pastikan asal URL iframe ActivityStartingState cocok dengan asal URL yang diberikan dalam manifes add-on. Untuk mengetahui informasi selengkapnya, lihat Keamanan add-on.
InvalidAddonStartingState URL iframe AddonStartingState tidak cocok dengan asal URL yang diberikan dalam manifes add-on. Pastikan asal URL iframe AddonStartingState cocok dengan asal URL yang diberikan dalam manifes add-on.
InvalidCloudProjectNumber Nomor project Cloud yang diberikan oleh Meet tidak cocok dengan nomor yang diteruskan oleh Meet add-ons SDK. Pastikan nomor project Cloud yang benar diteruskan ke SDK sebagai string saat memanggil properti createAddonSession atau metode exposeToMeetWhenScreenSharing(). Parameter ini otomatis ditambahkan oleh Meet ke URL iframe mana pun. Pastikan infrastruktur Anda tidak mengubah parameter URL (misalnya, sebagai bagian dari pengalihan) sebelum menggunakan nilai yang diteruskan.
MeetingPolicyPreventsStartingActivity Kebijakan rapat (seperti menggunakan setelan kontrol host) mencegah pengguna memulai aktivitas. Minta host atau administrator rapat mengubah setelan yang diperlukan agar pengguna saat ini dapat memulai aktivitas.
MissingUrlParameter Parameter URL Meet add-ons SDK yang diperlukan tidak ada. Parameter ini otomatis ditambahkan oleh Meet ke URL iframe. Pastikan infrastruktur Anda tidak mengubah parameter URL (misalnya, sebagai bagian dari pengalihan).
NeedsMainStageContext Metode ini hanya dapat dipanggil jika add-on berjalan di tahap utama. Gunakan properti getFrameType untuk memeriksa apakah add-on berjalan di tahap utama sebelum memanggil metode ini.
NeedsSidePanelContext Metode ini hanya dapat dipanggil jika add-on berjalan di panel samping. Gunakan properti getFrameType untuk memeriksa apakah add-on berjalan di panel samping sebelum memanggil metode ini.
NoActivityFound Tidak ada aktivitas yang ditemukan saat melakukan operasi. Pastikan aktivitas dimulai sebelum melakukan operasi ini.
NotSupportedInMeetCall Metode ini tidak didukung dalam panggilan Meet. Jangan panggil metode ini selama panggilan Meet.
NotSupportedInStandalone Metode ini tidak didukung dalam mode mandiri. Jangan panggil metode ini dalam mode mandiri.
RequiresEapEnrollment Metode yang diminta memerlukan pendaftaran EAP. Pendaftaran akses awal add-on Google Meet ditutup.
SizeLimitExceededActivityStartingState Ukuran URL ActivityStartingState dan/atau datanya melebihi batas yang diizinkan. Pastikan ukuran URL ActivityStartingState kurang dari 512 karakter dan ukuran data tambahan kurang dari 4.096 karakter.
SizeLimitExceededAddonStartingState Ukuran URL AddonStartingState dan/atau datanya melebihi batas yang diizinkan. Pastikan ukuran URL AddonStartingState kurang dari 512 karakter dan ukuran data tambahan kurang dari 4.096 karakter.
SizeLimitExceededFrameToFrameMessage Ukuran pesan antar-frame melebihi batas yang diizinkan. Pastikan ukuran pesan antar-frame kurang dari 1.000.000 karakter.
UserCancelled Pengguna membatalkan aktivitas yang dimulai. Pengguna harus mengklik Lanjutkan untuk memulai aktivitas.
UserNotInitiator Pengguna bukan inisiator aktivitas saat ini. Pastikan pengguna adalah inisiator aktivitas saat ini atau aktivitas telah berakhir.