Mengelola objek klien

Halaman ini menjelaskan cara mengelola objek klien yang add-on perlu 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 tersebut, dua objek klien dapat dibuat:

  • MeetMainStageClient untuk add-on yang berjalan di utama , yang dapat diambil menggunakan await session.createMainStageClient().

  • MeetSidePanelClient untuk add-on yang berjalan di sisi , yang dapat diambil menggunakan await session.createSidePanelClient().

Penting untuk mengambil objek klien yang benar baik untuk tahap utama atau panel samping. Jika klien yang salah diambil, SDK Add-on Google Meet akan menampilkan suatu 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 panggung 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:

  • getActivityStartingState() yang mendapatkan informasi tentang status awal tambahan saat peserta menerima undangan untuk bergabung ke aktivitas.
  • getMeetingInfo() yang mendapatkan detail tentang pertemuan di mana add-on aktif.
  • Metode setActivityStartingState() yang menetapkan status awal add-on saat peserta menerima undangan untuk bergabung ke aktivitas.
  • Untuk daftar fitur lengkap pada kedua klien, lihat 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.

  • unloadSidePanel() akan 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: