通过

基于自适应卡片的Loop组件

  • 项目

注意

基于自适应卡片的Loop组件在 macOS 和移动客户端上的 Microsoft Teams 和 Microsoft Outlook 中不可用。

基于自适应卡片的Loop组件使你能够在跨 Microsoft 365 的 Teams 消息扩展中构建协作体验。 基于自适应卡片的Loop组件具有可操作的内容，使用户能够进行实时更新，而无需在 Microsoft 365 应用（如 Teams 和 Outlook）之间切换上下文。

下面是基于自适应卡片的Loop组件的示例：

屏幕截图显示基于自适应卡片的Loop组件。

生成基于自适应卡片的Loop组件

若要生成基于自适应卡片的Loop组件，请执行以下步骤：

  1. 使用搜索命令生成消息扩展。

  2. 将 链接展开 添加到消息扩展。

  3. 对自适应卡片使用通用操作并定义 refresh 属性，以确保卡始终是最新的。 有关详细信息，请参阅 最新卡片。

  4. 跨 Microsoft 365 扩展消息扩展。 此步骤包括以下操作：

    1. 将应用清单更新到版本 1.13 或更高版本。
    2. 为机器人添加 Microsoft 365 通道。
    3. 更新单一登录的 Microsoft Entra 应用注册 (SSO) 。

  5. 在 metadata.webUrl 属性中添加唯一标识卡的 URL。 属性metadata.webUrl支持通过Loop组件标头中的“复制组件”按钮实现可移植性。

  6. 将邮件扩展添加到 Teams 并在 Outlook 中预览邮件扩展。 或者，还可以使用“概述”页上的“在 Teams 中预览”按钮在 Teams 开发人员门户中调试应用。

    开发人员门户的概述页的屏幕截图，其中突出显示了红色的“在 Teams 中预览”按钮。

注意

确保基于自适应卡片的Loop组件遵循设计准则，为用户构建可操作且一致的基于自适应卡片的体验。

示例

以下 JSON 有效负载是具有 和 webUrl 属性的基于自适应卡片Loop组件metadata的示例：

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "refresh": {
    "action": {
      "type": "Action.Execute",
      "title": "Submit",
      "verb": "personalDetailsCardRefresh"
    },
    "userIds": []
  },
  "body": [
    {
      ....
    },
  ]
  }

架构

属性 类型 说明
metadata Metadata 定义通常不用于呈现卡的各种元数据属性。
webUrl String 唯一标识卡并充当浏览器回退的 URL，可供某些主机使用。

注意

  • 复制基于自适应卡片的Loop组件时，将复制Loop组件的 URL。 将 URL 粘贴到 Teams 聊天或Loop应用中时，链接将展开到基于自适应卡片的Loop组件中。
  • 基于自适应卡片的Loop组件使用与常规自适应卡片相同的刷新机制。 仅当用户打开Loop组件时，基于自适应卡片的Loop组件中的内容才会刷新。

代码示例

示例名称 说明 Node.js .NET 清单
具有基于自适应卡片Loop组件的消息扩展 此示例演示如何使用基于自适应卡片的Loop组件创建消息扩展。 View View View

另请参阅