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