Teams 的生成选项卡

选项卡是嵌入 Microsoft Teams、Outlook 和 Microsoft 365 中的客户端感知网页。 它们是简单的 HTML <iframe/> 标记,指向在应用清单中声明的域,并且可以添加为团队内部频道、群组聊天或个人用户的个人应用的一部分。 可在应用中包含自定义选项卡,以便在 Teams 中嵌入自己的 Web 内容,或将 Teams 特定的功能添加到 Web 内容。 有关详细信息,请参阅 Teams JavaScript 客户端库

重要

自定义选项卡在政府社区云中可用, (GCC) 、GCC-High 和国防部 (DOD) 。

有两种类型的选项卡:静态选项卡和可配置选项卡。 可以在三个不同的范围内使用这些选项卡: personalgroupchatteams个人 (静态) 选项卡以及个人范围的机器人是个人应用的一部分,这些应用的范围限定为单个用户,并固定到左侧导航栏以便于访问。 个人 (个人范围内的静态) 选项卡继续以相同的方式工作。 但是,现在可以将静态选项卡扩展到具有可自定义体验的群组聊天、频道或会议。

聊天、频道或会议中的选项卡的行为更类似于应用,因为每个应用只能固定一个选项卡。 例如,只能在会议中固定一个 YouTube 应用选项卡。 会议中的静态选项卡也可以由 IT 管理员在会议中预先固定。

下图显示了添加到 Teams 中不同上下文的选项卡:

Teams 桌面版

 屏幕截图显示添加到个人范围的选项卡。

Teams 移动

示例显示正在个人上下文中添加的移动选项卡。

以下是聊天、频道和会议中静态选项卡的一些优势:

  • 可固定且即时:可以通过在聊天、频道和会议中添加选项卡图标固定具有静态选项卡 + 的应用。 这些选项卡可以取消固定,并且没有强制配置对话框,这允许你创建功能更类似于应用的选项卡。

  • 统一:可以创建一个静态选项卡,用于个人和组范围,例如聊天、频道和会议选项卡。

  • 可选配置:可以通过在 Teams 中固定应用后更改应用的属性来更改 contentUrl 选项卡实例中的默认 URL。

频道或组选项卡 也称为可配置选项卡,将内容传送到频道和群组聊天,是围绕基于 Web 的专用内容创建协作空间的一种方法。

下表可帮助你确定最适合你的应用:

  个人 频道 群组聊天 会议
静态选项卡 ✔️ ✔️ ✔️ ✔️
可配置的选项卡 ✔️ ✔️ ✔️

注意

如果你在应用清单中为特定范围定义了 可配置的选项卡静态选项卡 ,则默认情况下,Teams 会固定静态选项卡。

可以在 TeamsJS v1.x) 中创建 内容页 作为个人静态选项卡、频道或组选项卡或对话 (称为任务模块的一部分。 可以 创建一个配置页 ,使用户能够配置 Microsoft Teams 应用,并使用它来为 Microsoft 365 组配置个人、频道或群组聊天选项卡、消息扩展或连接器卡片。 你可以允许用户在安装后重新配置选项卡,并为应用程序创建选项卡删除页。 生成包含选项卡的 Teams 应用时,必须在 Android 和 iOS Teams 客户端上测试选项卡函数。 选项卡必须通过基本信息、区域设置、主题信息,以及标识选项卡中的内容的 entityIdsubEntityId获取上下文

注意

帖子文件无法从其位置移动。

选项卡功能

选项卡功能如下所示:

  • 如果向同样具有机器人的应用添加了选项卡,则机器人也会添加到团队中。
  • Microsoft当前用户的 Entra ID 的感知。
  • 用户的区域设置感知,以指示 en-us 的语言。
  • 单一登录 (SSO) 功能(如果支持)。
  • 能够使用机器人或应用通知来深层链接到选项卡或服务中的子实体,例如单个工作项。
  • 能够从选项卡中的链接打开模式对话框。
  • 在选项卡中重复使用 SharePoint Web 部件。

选项卡用户方案

Scenario:在 Teams 中引入现有的基于 Web 的资源。 例: 在 Teams 应用中创建一个静态选项卡,用于向用户显示一个信息性公司网站。

Scenario:向 Teams 机器人或消息传递扩展添加支持页面。 例:创建静态选项卡,向用户提供有关和帮助网页内容。

Scenario:为协作对话和协作提供对用户定期交互的项目的访问权限。 Example:创建一个频道或组选项卡,其中包含各个项目的深层链接。

了解选项卡的工作原理

可以使用以下方法之一创建选项卡:

在应用清单中声明自定义选项卡

自定义选项卡在应用包的应用清单中声明。 对于要作为选项卡包含在应用中的每个网页,可以定义一个 URL 和一个范围。 此外,可以将 Teams JavaScript 客户端库 添加到页面,并在页面加载后调用 microsoftTeams.initialize() 。 Teams 显示你的页面并提供对 Teams 特定信息的访问权限,例如 Teams 客户端正在运行深色主题。

无论你选择在频道、组还是个人范围内公开选项卡,都必须在选项卡中显示 <iframe> HTML 内容页 。对于静态选项卡,直接在 Teams 应用清单 中通过 contentUrl 数组中的 staticTabs 属性设置内容 URL。 选项卡的内容对于所有用户都是相同的。

注意

Teams 应用无法使用本机插件,因为它们在沙盒 iframe 中运行。

对于频道或组选项卡,还可以创建额外的配置页面。 此页允许配置内容页 URL,通常通过使用 URL 查询字符串参数加载该上下文的相应内容。 这是因为频道或组选项卡可以添加到多个团队或群组聊天。 每次后续安装时,用户都可以配置选项卡,以便根据需要定制体验。 当用户添加或配置选项卡时,URL 与 Teams 用户界面 (UI) 中显示的选项卡相关联。 配置选项卡只是向该 URL 添加更多参数。 例如,添加 Azure Boards 选项卡时,可选择配置页加载选项卡的哪个板。 配置页 URL 由configurationUrl应用清单configurableTabs数组中的 属性指定。

对于静态选项卡,可以将 固定 contentUrl 到聊天、频道或会议选项卡。 这允许跳过强制配置对话框,让用户更快地使用应用。 还可以在运行时更改 contentUrl 。 这允许你生成一个可在 Teams 的所有外围应用区域工作的选项卡对象。 有关详细信息,请参阅 将可配置选项卡迁移到静态选项卡。

可以有多个通道或组选项卡,每个应用最多可以有 16 个静态选项卡。

用于生成选项卡的工具

后续步骤

另请参阅