از طریق اشتراک‌گذاری صفحه نمایش، افزونه‌ای را برای کاربران تبلیغ کنید

تبلیغ یک افزونه از طریق اشتراک‌گذاری صفحه نمایش.

این صفحه نحوه تبلیغ یک افزونه را برای کاربران در حین اشتراک‌گذاری صفحه با Google Meet با قرار دادن مقدار کمی کد در یک صفحه وب دیگر توضیح می‌دهد.

روش MeetAddonScreenshare.exposeToMeetWhenScreensharing به سایت اجازه می دهد تا زمانی که برگه آن به اشتراک گذاشته می شود، اطلاعات را به Meet ارسال کند. این اطلاعات در تجربه افزودنی با Meet زمانی استفاده می‌شود که کاربر در صورت نصب افزونه، روی «شروع فعالیت» روی بنر ارائه کلیک می‌کند. اگر کاربر هنگام استفاده از برگه اشتراک‌گذاری روی صفحه، افزونه را نصب نکرده باشد، از او خواسته می‌شود که افزونه را نصب کند.

شی AddonScreenshareInfo شامل پنج فیلد است که می توانند بر اساس موارد استفاده اضافه شوند:

  • AddonScreenshareInfo.additionalData : اطلاعاتی که افزونه می تواند برای مقداردهی اولیه خود استفاده کند. فقط در صورتی تنظیم می شود که AddonScreenshareInfo.startActivityOnOpen درست باشد و با استفاده از CollaborationStartingState بتوان به آن دسترسی داشت. برای اطلاعات بیشتر، استفاده از حالت شروع همکاری را ببینید.

  • AddonScreenshareInfo.cloudProjectNumber : مورد نیاز. شماره پروژه Google Cloud افزونه.

  • AddonScreenshareInfo.mainStageUrl : آدرس اینترنتی که مرحله اصلی پس از شروع افزونه باز می شود، مانند https://www.example.com . نشانی وب باید به همان مبدأ مربوط به URL های مشخص شده در مانیفست افزودنی باشد.

  • AddonScreenshareInfo.sidePanelUrl : نشانی اینترنتی که پانل کناری پس از شروع افزونه باز می شود، مانند https://www.example.com . نشانی وب باید به همان مبدأ مربوط به URL های مشخص شده در مانیفست افزودنی باشد.

  • AddonScreenshareInfo.startActivityOnOpen : الزامی است. این که آیا بلافاصله وقتی کاربر افزونه را از بنر ارائه شروع می‌کند، تجربه افزودنی مشترک در Meet را شروع می‌کند یا خیر. اگر AddonScreenshareInfo.mainStageUrl استفاده می شود، باید درست باشد.

مثال: بارگذاری در مرحله اصلی

در نمونه کد زیر، از کاربری که صفحه وب را در Meet به اشتراک می‌گذارد که حاوی کد زیر است، خواسته می‌شود تا افزونه را راه‌اندازی کند:

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    mainStageUrl: MAIN_STAGE_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

موارد زیر را جایگزین کنید:

  • CLOUD_PROJECT_NUMBER : رشته. شماره پروژه ابری شما
  • MAIN_STAGE_URL : رشته. URL برای مرحله اصلی.

وقتی کاربر در صفحه تماس Meet صفحه را به اشتراک می گذارد، یک بنر ارائه را در Meet می بیند. با کلیک بر روی دکمه روی بنر، افزونه شماره پروژه ابری داده شده در مرحله اصلی باز می شود. AddonScreenshareInfo.mainStageUrl بارگیری می شود و AddonScreenshareInfo.additionalData برای تنظیم وضعیت شروع همکاری افزونه استفاده می شود. از دیگر کاربران حاضر در تماس بلافاصله خواسته می شود که افزونه را نصب یا راه اندازی کنند.

مثال: در پانل کناری بارگذاری کنید

در نمونه کد زیر، یک صفحه کاربر صفحه‌ای را با افزونه‌ای به اشتراک می‌گذارد که می‌خواهد در پانل کناری به جای مرحله اصلی شروع شود:

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: true,
    sidePanelUrl: SIDE_PANEL_URL,
    additionalData: "{\"selected_item\": \"42\"}",
  }
);
</script>

موارد زیر را جایگزین کنید:

  • CLOUD_PROJECT_NUMBER : رشته. شماره پروژه ابری شما
  • SIDE_PANEL_URL : رشته. URL برای پانل کناری.

وقتی کاربر در صفحه تماس Meet صفحه را به اشتراک می گذارد، یک بنر ارائه را در Meet می بیند. با کلیک بر روی دکمه روی بنر، افزونه شماره پروژه ابری داده شده در پانل کناری باز می شود. AddonScreenshareInfo.sidePanelUrl بارگیری می شود و AddonScreenshareInfo.additionalData برای تنظیم وضعیت شروع همکاری افزونه استفاده می شود. از دیگر کاربران حاضر در تماس بلافاصله خواسته می شود که افزونه را نصب یا راه اندازی کنند.

مثال: بدون شروع همکاری در پانل کناری بارگذاری کنید

در نمونه کد زیر، یک صفحه کاربر صفحه‌ای را با افزونه‌ای به اشتراک می‌گذارد که باید قبل از شروع فعالیت همکاری، مجوزهای منبع را تنظیم کند. با توجه به این نیاز، افزونه باید در پانل کناری شروع شود، بدون اینکه همکاری برای همه آغاز شود.

<script src="https://www.gstatic.com/meetjs/addons/0.1.0/meet.addons.screenshare.js"></script>
<script>
meet.addon.screensharing.exposeToMeetWhenScreensharing(
  {
    cloudProjectNumber: CLOUD_PROJECT_NUMBER,
    startActivityOnOpen: false,
    sidePanelUrl: SIDE_PANEL_URL,
  }
);
</script>

موارد زیر را جایگزین کنید:

  • CLOUD_PROJECT_NUMBER : رشته. شماره پروژه ابری شما
  • SIDE_PANEL_URL : رشته. URL برای پانل کناری.

وقتی کاربر در صفحه تماس Meet صفحه را به اشتراک می گذارد، یک بنر ارائه را در Meet می بیند. با کلیک بر روی دکمه روی بنر، افزونه شماره پروژه ابری داده شده در پانل کناری باز می شود. از آنجایی که AddonScreenshareInfo.startActivityOnOpen روی false تنظیم شده بود، دکمه شروع فعالیت غیرفعال است تا زمانی که CollaborationStartingState تنظیم شود. برای اطلاعات بیشتر، استفاده از حالت شروع همکاری را ببینید.

پس از شروع فعالیت، از سایر کاربران در تماس خواسته می‌شود که افزونه را راه‌اندازی یا نصب کنند.

تطبیق مبدا

مبداهای ارائه شده در AddonScreenshareInfo.mainStageUrl و AddonScreenshareInfo.sidePanelUrl با مبداهای موجود در مانیفست الحاقی شماره پروژه ابری ارائه شده مقایسه می شوند. اگر همه چیز مطابقت داشته باشد، کاربر مجاز است افزونه را راه اندازی کند.

علاوه بر این، مبدأ سایتی که اشتراک‌گذاری صفحه را آغاز می‌کند باید در قسمت addOnOrigins در مانیفست افزودنی فهرست شود.

برای اطلاعات بیشتر، امنیت افزونه را ببینید.