İstemci nesnelerini yönetme

Bu sayfada, bir eklentinin Google Meet ile iletişim kurmak için ihtiyaç duyduğu istemci nesnelerinin nasıl yönetileceği açıklanmaktadır.

Öncelikle eklentinin bir oturum oluşturması gerekir:

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

CLOUD_PROJECT_NUMBER kısmını, Google Cloud projenizin proje numarasıyla değiştirin.

Oturumdan iki istemci nesnesi oluşturulabilir:

• Ana sahnede çalışan bir eklentinin MeetMainStageClient değeri, await session.createMainStageClient() kullanılarak alınabilir.

• Yan panelde çalışan bir eklenti için MeetSidePanelClient, await session.createSidePanelClient() kullanılarak alınabilir.

Ana sahne veya yan panel için doğru istemci nesnesini almak önemlidir. Yanlış istemci alınırsa Google Meet eklentileri SDK'sı bir istisna oluşturur. Eklentinin hangi iFrame'de (ana sahne veya yan panel) çalıştığını kontrol etmek için getFrameType() yöntemini kullanın.

Aşağıdaki kod örneğinde, ana sahne istemci nesnesinin nasıl oluşturulacağı gösterilmektedir:

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

CLOUD_PROJECT_NUMBER yerine Cloud projenizin proje numarasını yazın.

Paylaşılan özellikler

Bazı özellikler hem MeetMainStageClient hem de MeetSidePanelClient nesnesinde kullanılabilirken diğer özellikler belirli bir istemciye özgüdür.

Örneğin, her iki istemcide de kullanılabilen bazı özellikler şunlardır:

• Katılımcı, etkinliğe katılma davetini kabul ettiğinde eklentinin ilk durumuyla ilgili bilgileri alan getActivityStartingState() yöntemi.
• Eklentinin çalıştığı toplantıyla ilgili ayrıntıları alan getMeetingInfo() yöntemi.
• Katılımcı etkinliğe katılma davetini kabul ettiğinde eklentinin ilk durumunu ayarlayan setActivityStartingState() yöntemi.
• Her iki istemcideki özelliklerin kapsamlı listesi için MeetAddonClient nesnesine bakın.

Müşteriye özel özellikler

Yalnızca MeetMainStageClient nesnesinde kullanılabilen özellikler:

• notifySidePanel() yöntemi, yan panele mesaj gönderir. İletiyi almak için yan paneldeki frameToFrameMessage geri arama özelliğine abone olmanız gerekir.

• loadSidePanel() yöntemi, yan panel iframe'ini açar. iframe kaynağı, bildirim dosyasındaki yan panel URL'sine ayarlanır.

• unloadSidePanel() yöntemi, yan panel iFrame'ini kapatır. Yöntem çağrıldığında eklenti durumu Meet'te korunmaz. Bu yöntem çağrılmadan önce eklenti durumunu kalıcı hale getirmek eklentinin sorumluluğundadır.

Yalnızca MeetSidePanelClient nesnesinde kullanılabilen özellikler:

• notifyMainStage() yöntemi, mainStage'e bir mesaj gönderir. İleti, ana sahnedeki frameToFrameMessage geri çağırma özelliğine abone olarak alınabilir.