自适应卡片中的媒体元素

  • 项目

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

自适应卡片通过访问 OneDrive 或 SharePoint 中提供的媒体文件来播放视频或音频剪辑。 可以在 Teams 中的自适应卡片中查看媒体文件。

以下屏幕截图显示了自适应卡片中的媒体元素：

注意

对于桌面客户端，自适应卡支持内联和全屏播放，而对于移动客户端，体验仅限于全屏和画中画 (PiP) (这样，当你打开其他应用) 时，可以在浮动窗口中watch视频。

将媒体元素添加到自适应卡片

可以使用 Teams 开发人员门户或自适应卡片Designer将媒体文件添加到现有或新的自适应卡片。 若要将媒体文件添加到自适应卡片，请执行以下步骤：

  1. 将媒体文件添加到 OneDrive 或 SharePoint。

  2. 为 DriveItem 创建共享链接或 URL。 还可以使用 OneDrive 或 SharePoint 中的 “共享”、“ 复制链接”或“ 复制链接” 选项获取链接或 URL。

    屏幕截图显示了可从中获取链接的位置。

    注意

    自适应卡片不支持直接从地址栏复制的媒体文件链接或 URL。

  3. 使用 Teams 开发人员门户或自适应卡片Designer打开现有自适应卡片或创建新的自适应卡片。

  4. 在左窗格中的 “元素”下，选择“ 媒体 ”，并将其添加到自适应卡片。

    屏幕截图显示了具有媒体元素的自适应卡片。

  5. 在“自定义卡结构标题”下，选择“媒体”。 此时将显示 “元素属性” 窗口。

  6. 在 “元素属性” 部分中，更新以下字段：

    • 在“ 源 ”部分下，在 URL 中输入媒体文件 URL。
    • 在“ 媒体 ”部分下，在 “海报 URL”中输入图像 URL。 有关详细信息，请参阅 自适应卡片媒体。

    屏幕截图显示了具有媒体元素的自适应卡片架构。

    注意

    仅移动客户端支持海报 URL。

  7. 选择“保存”，然后选择“向我发送此卡”。

    屏幕截图显示如何保存自适应卡并将其发送到 Teams

    包含媒体文件的自适应卡片已成功保存并发送到 Teams 聊天。 现在，可以在自适应卡片中播放媒体文件。

    屏幕截图显示 Teams 聊天中具有媒体文件的自适应卡。

示例

以下代码显示了具有媒体元素的自适应卡片的示例：

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.6",
  "fallbackText": "This card requires CaptionSource to be viewed. Ask your platform to update to Adaptive Cards v1.6 for this and more!",
  "body": [
    {
      "type": "Media",
      "poster": "https://adaptivecards.io/content/poster-video.png",
      "sources": [
    {
          "mimeType": "video/mp4",
          "url": "https://adaptivecardsblob.blob.core.windows.net/assets/AdaptiveCardsOverviewVideo.mp4"
    }
      ]
    }
  ]
}

限制

  • 自适应卡片仅支持在 SharePoint 或 OneDrive 中上传的媒体文件。
  • 确保用户有权访问 SharePoint 或 OneDrive 中可用的媒体文件。

代码示例

示例名称 Description .NET
自适应卡片中的媒体元素 此示例演示用户如何使用媒体文件发送自适应卡片。 View

另请参阅