本页介绍了如何通过在另一个网页上放置少量代码,在与 Google Meet 共享标签页的同时向用户推广插件。
使用 MeetAddonScreenshare.exposeToMeetWhenScreensharing
方法,网站可以在其标签页被共享时向 Meet 发送信息。当用户点击演示文稿横幅上的“开始活动”时(如果他们安装了此插件),此信息将用于 Meet 插件体验。如果用户在屏幕共享标签页时尚未安装该插件,则系统会提示他们安装该插件。
AddonScreenshareInfo
对象包含五个字段,可以根据用例添加这些字段:
AddonScreenshareInfo.additionalData
:插件可用于初始化自身的信息。仅当AddonScreenshareInfo.startActivityOnOpen
为 true 时才能设置,并且可通过CollaborationStartingState
访问。如需了解详情,请参阅使用协作发起状态。AddonScreenshareInfo.cloudProjectNumber
:必需。插件的 Google Cloud 项目编号。AddonScreenshareInfo.mainStageUrl
:插件启动后主界面会打开的网址,例如https://www.example.com
。该网址必须与插件清单中指定的网址属于同一来源。AddonScreenshareInfo.sidePanelUrl
:插件启动后侧边栏会打开的网址,例如https://www.example.com
。该网址必须与插件清单中指定的网址属于同一来源。AddonScreenshareInfo.startActivityOnOpen
:必需。当用户从演示横幅启动插件时,是否立即在 Meet 中启动协作插件体验。如果使用AddonScreenshareInfo.mainStageUrl
,则必须为 true。
示例:在主 Stage 中加载
在以下代码示例中,当用户通过屏幕共享包含以下代码的网页时,系统会提示其启动插件:
<script src="https://www.gstatic.com/meetjs/addons/0.7.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.7.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.7.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.mainStageUrl
和 AddonScreenshareInfo.sidePanelUrl
中提供的源站会与所提供的 Cloud 项目编号的插件清单中的源站进行比较。如果一切都符合,用户将可以启动插件。
此外,启动屏幕共享的网站的来源必须列在插件清单的 addOnOrigins
字段中。
如需了解详情,请参阅插件安全性。