Teams 的生成选项卡
本文内容
选项卡是嵌入 Microsoft Teams、Outlook 和 Microsoft 365 中的客户端感知网页。 它们是简单的 HTML <iframe/> 标记，指向在应用清单中声明的域，并且可以添加为团队内部频道、群组聊天或个人用户的个人应用的一部分。 可在应用中包含自定义选项卡，以便在 Teams 中嵌入自己的 Web 内容，或将 Teams 特定的功能添加到 Web 内容。 有关详细信息，请参阅 Teams JavaScript 客户端库 。
重要
自定义选项卡在政府社区云中可用， (GCC) 、GCC-High 和国防部 (DOD) 。
有两种类型的选项卡：静态选项卡和可配置选项卡。 可以在三个不同的范围内使用这些选项卡： personal、 groupchat和 teams。
个人 (静态) 选项卡 以及个人范围的机器人是个人应用的一部分，这些应用的范围限定为单个用户，并固定到左侧导航栏以便于访问。 个人 (个人范围内的静态) 选项卡继续以相同的方式工作。 但是，现在可以将静态选项卡扩展到 具有可自定义体验 的群组聊天、频道或会议。
聊天、频道或会议中的选项卡的行为更类似于应用，因为每个应用只能固定一个选项卡。 例如，只能在会议中固定一个 YouTube 应用选项卡。 会议中的静态选项卡也可以由 IT 管理员在会议中预先固定。
下图显示了添加到 Teams 中不同上下文的选项卡：
Teams 桌面版
Teams 移动
Teams 桌面版
Teams 移动
Teams 桌面版
Teams 移动
以下是聊天、频道和会议中静态选项卡的一些优势：
可固定且即时 ：可以通过在聊天、频道和会议中添加选项卡图标固定具有静态选项卡 + 的应用。 这些选项卡可以取消固定，并且没有强制配置对话框，这允许你创建功能更类似于应用的选项卡。
统一 ：可以创建一个静态选项卡，用于个人和组范围，例如聊天、频道和会议选项卡。
可选配置 ：可以通过在 Teams 中固定应用后更改应用的属性来更改 contentUrl 选项卡实例中的默认 URL。
频道或组选项卡 也称为可配置选项卡，将内容传送到频道和群组聊天，是围绕基于 Web 的专用内容创建协作空间的一种方法。
下表可帮助你确定最适合你的应用：
注意
如果你在应用清单中为特定范围定义了 可配置的选项卡 和 静态选项卡 ，则默认情况下，Teams 会固定静态选项卡。
可以在 TeamsJS v1.x) 中创建 内容页 作为个人静态选项卡、频道或组选项卡或对话 (称为任务模块的一部分。 可以创建一个配置页 ，使用户能够配置Microsoft Teams 应用，并使用它来配置个人、频道或群聊选项卡、消息传递扩展或连接器卡，以便Microsoft 365 组。 你可以允许用户在安装后重新配置选项卡，并为应用程序创建选项卡删除页 。 生成包含选项卡的 Teams 应用时，必须在 Android 和 iOS Teams 客户端上测试选项卡函数 。 选项卡必须通过基本信息、区域设置、主题信息，以及标识选项卡中的内容的 entityId 或 subEntityId 来获取上下文 。
选项卡功能
选项卡功能如下所示：
如果向同样具有机器人的应用添加了选项卡，则机器人也会添加到团队中。
了解当前用户的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 个静态选项卡。
后续步骤
另请参阅
