این صفحه نحوه دریافت شی کلاینت را که یک افزونه برای ارتباط با Google Meet به آن نیاز دارد، توضیح می دهد.
ابتدا، افزونه باید یک جلسه ایجاد کند:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
از جلسه، دو شی کلاینت را می توان ایجاد کرد:
MeetMainStageClient
برای یک افزونه در حال اجرا در مرحله اصلی ، قابل بازیابی با استفاده ازawait session.createMainStageClient()
.MeetSidePanelClient
برای یک افزونه در حال اجرا در پانل کناری ، قابل بازیابی با استفاده ازawait session.createSidePanelClient()
.
بازیابی شیء مشتری صحیح برای صفحه اصلی یا پانل جانبی بسیار مهم است. اگر کلاینت اشتباهی بازیابی شود، Google Meet Add-ons SDK یک استثنا ایجاد می کند. برای بررسی اینکه افزونه در کدام iframe (مرحله اصلی یا پانل جانبی) اجرا می شود، از روش MeetAddon.getFrameType
استفاده کنید.
نمونه کد زیر نحوه نمونه سازی شی کلاینت مرحله اصلی را نشان می دهد:
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
const mainStageClient = await session.createMainStageClient();
عملکرد مشترک
برخی از عملکردها هم در MeetMainStageClient
و هم در MeetSidePanelClient
موجود است، در حالی که عملکردهای دیگر مختص یک کلاینت خاص است.
به عنوان مثال، برخی از عملکردهای موجود در هر دو مشتری عبارتند از:
- متد
MeetAddonClient.getCollaborationStartingState
که اطلاعاتی را در مورد وضعیت اولیه برافزا هنگامی که شرکتکننده دعوت به همکاری را میپذیرد، دریافت میکند. - روش
MeetAddonClient.getMeetingInfo
که جزئیات جلسه ای را که افزونه در آن اجرا می شود، دریافت می کند. - روش
MeetAddonClient.getMeetPlatformInfo
که جزئیات مربوط به پلتفرم جلسه ای را که افزونه در آن اجرا می شود، دریافت می کند. -
MeetAddonClient.setCollaborationStartingState
که وضعیت اولیه برافزا را زمانی که شرکتکننده دعوت به همکاری را میپذیرد، تنظیم میکند. - برای یک لیست جامع از عملکرد در هر دو کلاینت، شی
MeetAddonClient
را ببینید.
عملکرد خاص مشتری
عملکرد فقط در MeetMainStageClient
موجود است:
MeetMainStageClient.notifySidePanel
پیامی را به پانل کناری ارسال می کند. پیام را می توان با عضویت در پاسخ به تماس FrameToFrameMessage در پانل کناری دریافت کرد.متد
MeetMainStageClient.loadSidePanel
iframe پانل کناری را باز می کند. منبع iframe روی URL پانل کناری از فایل مانیفست تنظیم شده است.متد
MeetMainStageClient.unloadSidePanel
، iframe پانل کناری را می بندد. هنگامی که متد فراخوانی می شود، وضعیت افزودنی در Meet حفظ نمی شود. این به افزونه بستگی دارد که قبل از فراخوانی این روش، هر حالت افزودنی را حفظ کند.
عملکرد فقط در MeetSidePanelClient
موجود است:
-
MeetSidePanelClient.notifyMainStage
یک پیام به mainStage ارسال می کند. پیام را میتوان با اشتراک در فریمتو فریم پیام در صفحه اصلی دریافت کرد.