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

通过屏幕共享宣传插件。

本页介绍了如何在使用 Google Meet 共享标签页的屏幕内容时,通过在其他网页上放置少量代码,向用户宣传插件。

通过 exposeToMeetWhenScreensharing() 方法可让该网站向 Meet 发送信息 其标签页在屏幕处于共享状态时显示这些信息会用于 在使用 Meet 时, 用户点击“启动活动”展示横幅上的 插件。如果用户没有 共享一个标签页时安装了插件, 提示您安装该插件。

通过 AddonScreenshareInfo 对象包含五个属性,可根据用例进行添加:

  • additionalData: 插件可用于初始化自身的信息。罐形 仅当 startActivityOnOpen 属性为 true 时才设置,可以 使用 ActivityStartingState。 如需了解详情,请参阅使用 activity 启动 状态

  • cloudProjectNumber: 必填。您的 Google Cloud 项目的编号。

  • mainStageUrl: 插件在主界面打开的网址 开始,例如 https://www.example.com。该网址必须属于 origin 指定为 插件清单

  • sidePanelUrl: 插件在侧边栏打开的网址 开始,例如 https://www.example.com。该网址必须属于 origin 指定为 插件清单

  • startActivityOnOpen:必填。是否启动 activity 插件 即可立即体验 Meet 中的精彩体验 插件。必须为 true 如果使用了 mainStageUrl 属性。

示例:在主界面中加载

在下面的代码示例中,屏幕共享 系统会提示包含以下代码的 Meet 启动 插件:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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:字符串。您的 Google Cloud 项目。
  • MAIN_STAGE_URL:字符串。主舞台的网址。

当用户在 Meet 通话屏幕中分享网页时,会在 Meet 中看到演示文稿横幅。点击横幅上的按钮 会打开指定 Cloud 项目编号的插件, 主舞台上系统会加载 mainStageUrl 属性, additionalData 属性用于设置 activity 开始 状态通话中的其他用户 立即提示安装或启动该插件。

示例:在侧边栏中加载

在以下代码示例中,用户界面与一个想要在侧边栏(而非主舞台)中启动的插件共享一个页面:

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 通话屏幕共享页面时,会看到 展示横幅。点击横幅上的按钮 会打开指定 Cloud 项目编号的插件, 。系统会加载 sidePanelUrl 属性, additionalData 属性用于设置 activity 开始 状态通话中的其他用户 立即提示安装或启动该插件。

示例:在侧边栏中加载,而无需启动 activity

在以下代码示例中,用户屏幕与 插件,必须先调整资源权限,然后才能 活动。为此, 插件应在侧边栏中启动,而不使用 为所有人启动一项活动

<script src="https://www.gstatic.com/meetjs/addons/1.0.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 通话屏幕共享页面时,会看到 展示横幅。点击横幅上的按钮 会打开指定 Cloud 项目编号的插件, 。由于 startActivityOnOpen 属性设置为 false,则“启动 Activity”按钮将处于停用状态,直到 已设置 ActivityStartingState。有关详情,请参阅使用 activity 启动状态

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

源匹配

系统会将 mainStageUrl 属性和 sidePanelUrl 属性中提供的来源与所提供 Cloud 项目编号的插件清单中的来源进行比较。如果所有项目均匹配,则用户 可以发布该插件。

此外,必须列出发起屏幕共享的网站的来源 (在插件的 addOnOrigins 字段中) 清单

有关详情,请参阅插件 安全性