Bu sayfada, eklentinin Google Meet ile iletişim kurması için ihtiyaç duyduğu istemci nesnelerinin nasıl yönetileceği açıklanmaktadır.
İlk olarak eklentinin 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 aşamada çalışan bir eklenti için
await session.createMainStageClient()
kullanılarak alınabilenMeetMainStageClient
.Yan panelde çalışan bir eklenti için
await session.createSidePanelClient()
kullanılarak alınabilenMeetSidePanelClient
.
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 müşteriye özeldir.
Ö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 durumu hakkında bilgi edinen
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 istemcide de bulunan özelliklerin kapsamlı bir listesi için
MeetAddonClient
nesnesine bakın.
İstemciye özgü özellikler
Yalnızca MeetMainStageClient
nesnesinde kullanılabilen özellikler:
notifySidePanel()
yöntemi, yan panele bir mesaj gönderir. İleti, yan paneldekiframeToFrameMessage
geri çağırma işlevine abone olarak alınabilir.loadSidePanel()
yöntemi, yan panel iframe'ini açar. İframe kaynağı, manifest dosyasından alınan 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 saklanmaz. Bu yöntem çağrılmadan önce eklenti durumunu korumak eklentiye bağlıdır.
Yalnızca MeetSidePanelClient
nesnesinde kullanılabilen özellikler:
notifyMainStage()
yöntemi, ana sahneye bir mesaj gönderir. Mesaj, ana sahnedeframeToFrameMessage
geri çağırma mülküne abone olarak alınabilir.