Bu sayfada, bir eklentinin Google Meet ile iletişim kurabilmesi için gereken istemci nesnesinin nasıl alınacağı açıklanmaktadır.
Eklentinin öncelikle bir oturum oluşturması gerekir:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
Oturumdan iki istemci nesnesi oluşturulabilir:
Ana aşamada çalışan bir eklenti için
MeetMainStageClient
.await session.createMainStageClient()
ile alınabilir.Yan panelde çalışan bir eklenti için
MeetSidePanelClient
(await session.createSidePanelClient()
ile alınabilir).
Ana sahne veya yan panel için doğru istemci nesnesinin alınması ö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 MeetAddon.getFrameType
yöntemini kullanın.
Aşağıdaki kod örneğinde, ana aşama istemci nesnesinin nasıl örnekleneceği gösterilmektedir:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
const mainStageClient = await session.createMainStageClient();
Paylaşılan işlevler
Bazı işlevler hem MeetMainStageClient
hem de MeetSidePanelClient
'de sunulurken diğer işlevler belirli bir istemciye özeldir.
Örneğin, her iki istemcide de bulunan bazı işlevler şunlardır:
- Katılımcı ortak çalışma davetini kabul ettiğinde eklentinin ilk durumuyla ilgili bilgi alan
MeetAddonClient.getCollaborationStartingState
yöntemi. - Eklentinin çalıştığı toplantıyla ilgili ayrıntıları alan
MeetAddonClient.getMeetingInfo
yöntemi. - Eklentinin çalıştığı toplantı platformu hakkında ayrıntıları alan
MeetAddonClient.getMeetPlatformInfo
yöntemi. - Katılımcı ortak çalışma davetini kabul ettiğinde eklentinin başlangıç durumunu ayarlayan
MeetAddonClient.setCollaborationStartingState
. - Her iki istemcideki işlevlerin kapsamlı bir listesi için
MeetAddonClient
nesnesine bakın.
İstemciye özgü işlevler
Yalnızca MeetMainStageClient
'da kullanılabilen işlevler:
MeetMainStageClient.notifySidePanel
, yan panele bir mesaj gönderir. Mesaj, yan paneldeki frameToFrameMessage geri çağırmaya abone olarak alınabilir.MeetMainStageClient.loadSidePanel
yöntemi, yan panel iframe'ini açar. iframe kaynağı, manifest dosyasındaki yan panel URL'sine ayarlanır.MeetMainStageClient.unloadSidePanel
yöntemi, yan panel iframe'ini kapatır. Yöntem çağrıldığında eklenti durumu Meet'te saklanmaz. Bu yöntem çağrılmadan önce herhangi bir eklenti durumunu korumak eklentiye bağlıdır.
Yalnızca MeetSidePanelClient
'da kullanılabilen işlevler:
MeetSidePanelClient.notifyMainStage
, mainStage'e bir mesaj gönderir. Mesaj, ana sahnede frameToFrameMessage geri çağırmaya abone olarak alınabilir.