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 Google Cloud Anda.

Dari sesi tersebut, dua objek klien dapat dibuat:

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

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

Penting untuk mengambil objek klien yang benar untuk tahap utama atau panel samping. Jika klien yang salah diambil, Google Meet Add-on SDK akan memunculkan 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 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 dengan 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 lengkap fitur di kedua klien, lihat objek MeetAddonClient.

Fitur khusus klien

Fitur hanya tersedia di objek MeetMainStageClient:

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

• Metode loadSidePanel() membuka iframe panel samping. Sumber iframe disetel 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 yang akan mempertahankan status add-on apa pun sebelum metode ini dipanggil.

Fitur hanya tersedia di objek MeetSidePanelClient:

• Metode notifyMainStage() mengirim pesan ke mainStage. Pesan dapat diterima dengan berlangganan properti callback frameToFrameMessage di mainstage.