Mengelola objek klien

Halaman ini menjelaskan cara mengelola objek klien yang diperlukan add-on untuk berkomunikasi dengan Google Meet.

Pertama, add-on perlu membuat sesi:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

Ganti CLOUD_PROJECT_NUMBER dengan nomor project project Google Cloud Anda.

Dari sesi, dua objek klien dapat dibuat:

Penting untuk mengambil objek klien yang benar untuk panggung utama atau panel samping. Jika klien yang salah diambil, SDK Add-on Google Meet akan menampilkan pengecualian. Untuk memeriksa iframe (tahap utama atau panel samping) tempat add-on berjalan, gunakan metode getFrameType().

Contoh kode berikut menunjukkan cara membuat instance objek klien tahap utama:

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

Ganti CLOUD_PROJECT_NUMBER dengan nomor project project Cloud Anda.

Fitur bersama

Beberapa fitur tersedia di objek MeetMainStageClient dan MeetSidePanelClient, sedangkan fitur lainnya khusus untuk klien tertentu.

Misalnya, beberapa fitur yang tersedia di kedua klien meliputi:

  • Metode getActivityStartingState() yang mendapatkan informasi tentang status awal add-on saat peserta menerima undangan untuk bergabung ke aktivitas.
  • Metode getMeetingInfo() yang mendapatkan detail tentang rapat tempat add-on berjalan.
  • Metode setActivityStartingState() yang menetapkan status awal add-on saat peserta menerima undangan untuk bergabung ke aktivitas.
  • Untuk mengetahui daftar fitur lengkap di kedua klien, lihat objek MeetAddonClient.

Fitur khusus klien

Fitur yang hanya tersedia di objek MeetMainStageClient:

  • Metode notifySidePanel() mengirim pesan ke panel samping. Pesan dapat diterima dengan berlangganan callback frameToFrameMessage di panel samping.

  • Metode loadSidePanel() akan membuka iframe panel samping. Sumber iframe ditetapkan ke URL panel samping dari file manifes.

  • Metode unloadSidePanel() menutup iframe panel samping. Status add-on tidak dipertahankan dalam Meet saat metode dipanggil. Add-on dapat mempertahankan status add-on sebelum metode ini dipanggil.

Fitur yang hanya tersedia di objek MeetSidePanelClient: