卡片

  • 项目

卡片是装载简短信息或相关信息的用户界面 (UI) 容器。 卡片可以有多个属性和附件，可以包含按钮，可触发 卡片操作。 使用卡片，可以将信息组织到组中，让用户有机会与信息的特定部分进行交互。

Microsoft Teams 机器人支持以下类型的卡片：

  • 自适应卡片
  • 主图卡片
  • 列表卡
  • 用于Microsoft 365 组的连接器卡
  • 收据卡
  • 登录卡
  • 缩略图卡片
  • 卡片集合
  • 自适应卡片上的“溢出”菜单

可以使用 Markdown 或 HTML 向卡片添加格式文本格式，具体取决于卡片类型。 机器人和 Teams 中的消息扩展使用的卡片，添加和响应这些卡操作openUrl、、messageBack、imBackinvoke、 和 signin。

Teams 在三个不同的位置使用卡片：

  • 连接器
  • 机器人
  • 消息扩展

连接器中的卡

卡片最初定义为 Outlook 和 Microsoft 365 的一部分，现在用作Microsoft 365 组连接器的一部分。 与许多 Microsoft 365 应用程序一样，Teams 支持连接器。 有关详细信息，请参阅为Microsoft 365 组创建连接器。 可以在 可操作邮件卡参考 中找到连接器中的卡片规范。

机器人中的卡片

Microsoft Bot Framework 通过添加一组预定义卡来扩展卡规范，机器人可以将其用作机器人消息的一部分。 Teams 支持使用 Bot Framework 的机器人，但它支持一组不同的卡片。 有关Bot Framework 中卡的常规信息，请参阅 将富卡附件添加到邮件。 这些卡在 Teams 中称为简单卡片。

Teams 中的机器人可以使用简单卡片、连接器卡或自适应卡片。 类型卡 提供有关卡的信息，由 Teams 中的机器人支持。

消息扩展中的卡片

消息扩展 还可以返回卡片。 消息扩展可以使用简单卡片、连接器卡或自适应卡片。 这些卡片位于 类型卡中。

卡片类型

Teams 使用的所有卡都列在类型卡中。 本参考还介绍了 Teams 中Bot Framework卡和卡片之间的差异。

自适应卡

自适应卡片是一种跨产品的规范，可应用于包括机器人、Cortana、Outlook 和 Windows 在内的各种 Microsoft 产品。 它是新 Teams 开发推荐使用的卡片类型。 有关自适应卡片团队的常规信息，请参阅 自适应卡片概述。 可以在使用现有主卡、Microsoft 365 卡和缩略图卡的任何位置使用自适应卡片。

除了自适应卡片，Teams 支持两种其他类型的卡片：

  • 连接器卡：用作Microsoft 365 组连接器的一部分。
  • 简单卡片：从 Bot Framework 使用，例如缩略图和主图卡片。

自适应卡片中的人员选取器

人员选取器 添加为自适应卡片中的输入控件，可以搜索和选择人员。 可以在聊天、频道、对话 (TeamsJS v1.x) 和选项卡中使用任务模块。 移动和桌面客户端支持人员选取器，提供了内联键入体验。

自适应卡片中的人员图标

自适应卡片中的人员图标可帮助用户查看 Teams 自适应卡片中的用户图像。 可以查看单个用户或多个用户的图像。 Teams 移动和桌面客户端支持人员图标。

在自适应卡片中键入提前搜索

在自适应卡片中添加为输入控件的“类型头搜索”支持动态加载数据集中的动态 搜索 体验。 它还允许用户在具有有限选择数的列表中执行类型化静态搜索。 移动和桌面客户端支持键入动态搜索体验。

自适应卡片中的媒体元素

自适应卡片中的媒体元素提供增强的媒体体验，并增加对自适应卡片的参与度。 可以将媒体文件（如音频或视频剪辑）添加到自适应卡片。 有关详细信息，请参阅 自适应卡片中的媒体元素。

自适应卡片和传入 Webhook

注意

借助传入 Webhook 自适应卡片，可以使用自适应卡片的丰富灵活功能。 它使用 Teams 中的传入 Webhook 从其 Web 服务发送数据。

自适应卡片中的 CodeBlock

使用 CodeBlock 元素在 Teams 聊天、频道和会议中将代码片段共享为格式丰富的自适应卡片。 具有 元素的 CodeBlock 自适应卡片使代码片段易于阅读，因为缩进、编号和语法突出显示与编程语言匹配。 有关详细信息，请参阅 自适应卡中的 CodeBlock。

自适应卡片响应布局

必须将自适应卡片设计为在任何设备上外观极佳，以便跨聊天、频道和会议聊天提供增强的用户体验。 自适应卡片响应布局有助于设计具有不同布局的卡片，以不同的卡宽度为目标。 有关详细信息，请参阅 自适应卡片响应布局。

自适应卡片上的“溢出”菜单

Teams 中的自适应卡片支持溢出菜单。 可以为自适应卡片中的所有辅助操作填充溢出菜单。

支持在用户提及中Microsoft Entra对象 ID 和 UPN

具有自适应卡的机器人支持用户提及 ID，例如Microsoft Entra对象 ID 和用户主体名称 (UPN) ，以及现有 ID。 传入 Webhook 开始使用 Microsoft Entra 对象 ID 和 UPN 支持自适应卡片中的用户提及。

后续步骤

卡片类型

另请参阅