Mendapatkan objek klien

Pratinjau Developer: Tersedia sebagai bagian dari Program Pratinjau Developer Google Workspace, yang memberikan akses awal ke fitur tertentu.

Halaman ini menjelaskan cara mendapatkan 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",
    });

Dari sesi ini, 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().

Anda harus mengambil objek klien yang benar untuk panggung utama atau panel samping. Jika klien yang salah diambil, Add-on SDK Google Meet akan menampilkan pengecualian. Untuk memeriksa iframe (tahap utama atau panel samping) tempat add-on dijalankan, gunakan metode MeetAddon.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();

Fungsi bersama

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

Misalnya, beberapa fungsi yang tersedia di kedua klien mencakup:

• Metode MeetAddonClient.getCollaborationStartingState yang mendapatkan informasi tentang status awal add-on saat peserta menerima undangan untuk berkolaborasi.
• Metode MeetAddonClient.getMeetingInfo yang mendapatkan detail tentang rapat tempat add-on dijalankan.
• Metode MeetAddonClient.getMeetPlatformInfo yang mendapatkan detail tentang platform rapat tempat add-on dijalankan.
• MeetAddonClient.setCollaborationStartingState yang menetapkan status awal add-on saat peserta menerima undangan untuk berkolaborasi.
• Untuk daftar lengkap fungsi di kedua klien, lihat objek MeetAddonClient.

Fungsi khusus klien

Fungsi yang hanya tersedia di MeetMainStageClient:

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

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

• Metode MeetMainStageClient.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.

Fungsi yang hanya tersedia di MeetSidePanelClient:

• MeetSidePanelClient.notifyMainStage mengirim pesan ke mainStage. Pesan dapat diterima dengan berlangganan callback frameToFrameMessage di mainstage.