شرکت‌کنندگان در یک جلسه می‌توانند به طور مشترک روی یک فعالیت افزونه Google Meet کار کنند. هنگامی که یک فعالیت مشترک شروع می شود، همه شرکت کنندگان در جلسه اعلانی دریافت می کنند که فعالیت در حال انجام است.
این اعلان با وضعیت در دسترس بودن و نصب افزونه سازگار است:
اگر شرکت‌کننده افزونه را نصب کرده باشد : می‌تواند به فعالیت بپیوندد.
اگر شرکت‌کننده افزونه را نصب نکرده باشد : به او دستور داده می‌شود که افزونه را نصب کند.
اگر افزونه برای پلتفرم شرکت‌کننده در دسترس نیست : به آنها اطلاع داده می‌شود که نمی‌توانند با استفاده از دستگاه فعلی خود به فعالیت بپیوندند.
وقتی کاربر به فعالیت می‌پیوندد، iframes خود را با محتوای افزودنی شما بارگیری می‌کند. می‌توانید تنظیم کنید که آیا وصال‌های جدید باید فعالیت مشترک را در مرحله اصلی یا پانل جانبی باز کنند یا خیر.
همکاری را شروع کنید
یک فعالیت با فراخوانی متد startCollaboration شروع می شود که از یک رابط CollaborationStartingState استفاده می کند.
مرحله 1 (اختیاری): افزونه وضعیت شروع همکاری را تنظیم می کند
MeetAddonClient.setCollaborationStartingState اطلاعات مربوط به وضعیت اولیه برافزا را تنظیم یا به روز می کند که در هنگام پذیرفتن دعوت به همکاری توسط شرکت کننده استفاده می شود.
این افزونه می‌تواند در هر زمان قبل یا در طول همکاری، CollaborationStartingState با استفاده از Meet Add-ons SDK تنظیم کند. پس از شروع فعالیت افزونه، سایر شرکت کنندگان جلسه از CollaborationStartingState برای مقداردهی اولیه افزونه خود استفاده می کنند.
برای جزئیات و نمونه کد در مورد نحوه تنظیم CollaborationStartingState ، به استفاده از حالت شروع همکاری مراجعه کنید.
مرحله 2: افزونه فعالیت را شروع می کند
فعالیت زمانی شروع می شود که افزونه متد startCollaboration را در MeetSidePanelClient فراخوانی می کند.
پس از تکمیل انتخاب محتوا و آماده شدن برای شروع همکاری، مطمئن شوید که روش startCollaboration در افزونه خود فراخوانی کنید.
نمونه کد زیر نحوه فراخوانی متد startCollaboration را نشان می دهد:
sidePanelClient.startCollaboration({
mainStageUrl: "https://app.example.com/mainstage",
additionalData: JSON.stringify({
// State to send to participants.
})
});
هنگامی که startCollaboration فراخوانی می شود، Meet اقدامات زیر را انجام می دهد:
برای سایر شرکت کنندگان : Meet اعلانی را نشان می دهد که فعالیت در حال انجام است.
برای آغازگر : اگر URL مرحله اصلی در
CollaborationStartingStateمشخص شده بود، Meet با استفاده از URL ازCollaborationStartingState، مرحله اصلی را باز می کند.
حالت افزودنی را در یک همکاری به اشتراک بگذارید
وقتی کاربر به همکاری ملحق می‌شود، بسته به CollaborationStartingState ، افزونه شما را در صفحه اصلی یا پانل جانبی بارگذاری می‌کند.
با ویژگی additionalData ، می توانید داده های اولیه (که به آن حالت نیز گفته می شود) با کاربرانی که به همکاری می پیوندند به اشتراک بگذارید. همچنین ممکن است بخواهید هنگام تعامل با افزونه شما، وضعیت را بین کاربران به اشتراک بگذارید.
شما می توانید حالت را به چند روش به اشتراک بگذارید:
- خودتان آن را با مکانیسم های همگام سازی خودتان مدیریت کنید.
- از Meet Live Sharing SDK استفاده کنید، که راهی راحت و سریع برای اشتراک‌گذاری داده‌های دلخواه بین کاربران است.