通过屏幕共享向用户宣传插件

通过屏幕共享推广插件。

本页介绍了如何通过在另一个网页上放置少量代码,在与 Google Meet 共享标签页的同时向用户推广插件。

使用 MeetAddonScreenshare.exposeToMeetWhenScreensharing 方法,网站可以在其标签页被共享时向 Meet 发送信息。当用户点击演示文稿横幅上的“开始活动”时(如果他们安装了此插件),此信息将用于 Meet 插件体验。如果用户在屏幕共享标签页时尚未安装该插件,则系统会提示他们安装该插件。

AddonScreenshareInfo 对象包含五个字段,可以根据用例添加这些字段:

示例:在主 Stage 中加载

在以下代码示例中,当用户通过屏幕共享包含以下代码的网页时,系统会提示其启动插件:

<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:字符串。您的 Cloud 项目编号。
  • MAIN_STAGE_URL:字符串。主 Stage 的网址。

当 Meet 通话屏幕中的用户分享页面时,他们会在 Meet 中看到演示横幅。点击横幅上的按钮可打开主 Stage 中给定 Cloud 项目编号的插件。加载 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:字符串。您的 Cloud 项目编号。
  • SIDE_PANEL_URL:字符串。侧边栏的网址。

当 Meet 通话屏幕中的用户分享页面时,他们会在 Meet 中看到演示横幅。点击横幅上的按钮会在侧边栏中打开给定 Cloud 项目编号的插件。加载 AddonScreenshareInfo.sidePanelUrl,并使用 AddonScreenshareInfo.additionalData 设置插件的协作开始状态。通话中的其他用户会立即提示安装或启动该插件。

示例:在侧边栏中加载内容而不开始协作

在以下代码示例中,用户屏幕与插件共享一个页面,该插件必须调整资源权限,才能启动协作 activity。根据此要求,插件应在侧边栏中启动,而不会为所有人启动协作。

<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:字符串。您的 Cloud 项目编号。
  • SIDE_PANEL_URL:字符串。侧边栏的网址。

当 Meet 通话屏幕中的用户分享页面时,他们会在 Meet 中看到演示横幅。点击横幅上的按钮会在侧边栏中打开给定 Cloud 项目编号的插件。由于 AddonScreenshareInfo.startActivityOnOpen 已设为 false,因此启动 activity 按钮会处于停用状态,直到设置 CollaborationStartingState。如需了解详情,请参阅使用协作开始状态

activity 启动后,系统会提示调用中的其他用户启动或安装该插件。

来源匹配

AddonScreenshareInfo.mainStageUrlAddonScreenshareInfo.sidePanelUrl 中提供的源站会与所提供的 Cloud 项目编号的插件清单中的源站进行比较。如果一切都符合,用户将可以启动插件。

此外,启动屏幕共享的网站的来源必须列在插件清单addOnOrigins 字段中。

如需了解详情,请参阅插件安全性