自适应卡片中的媒体元素
自适应卡片中的媒体元素提供了增强的媒体体验,并增加了对自适应卡片的参与度。 可以将媒体文件(如音频或视频剪辑)添加到自适应卡片。
自适应卡片通过访问 OneDrive 或 SharePoint 中提供的媒体文件来播放视频或音频剪辑。 可以在 Teams 中的自适应卡片中查看媒体文件。
以下屏幕截图显示了自适应卡片中的媒体元素:
注意
对于桌面客户端,自适应卡支持内联和全屏播放,而对于移动客户端,体验仅限于全屏和画中画 (PiP) (,这使你可以在打开其他应用) 时在浮动窗口中观看视频。
将媒体元素添加到自适应卡片
可以使用 Teams 开发人员门户或自适应卡片设计器将媒体文件添加到现有或新的自适应卡片。 若要将媒体文件添加到自适应卡片,请执行以下步骤:
将媒体文件添加到 OneDrive 或 SharePoint。
为 DriveItem 创建共享链接或 URL。 还可以使用 OneDrive 或 SharePoint 中的 “共享”、“ 复制链接”或“ 复制链接” 选项获取链接或 URL。
注意
自适应卡片不支持直接从地址栏复制的媒体文件链接或 URL。
使用 Teams 开发人员门户 或自适应卡片设计器打开现有 自适应卡片或创建新的自适应卡片。
在左窗格中的 “元素”下,选择“ 媒体 ”,并将其添加到自适应卡片。
在 “自定义卡片结构标题”下,选择“ 媒体”。 此时将显示 “元素属性” 窗口。
在 “元素属性” 部分中,更新以下字段:
- 在“ 源 ”部分下,在 URL 中输入媒体文件 URL。
- 在“ 媒体 ”部分下,在 “海报 URL”中输入图像 URL。 有关详细信息,请参阅 自适应卡片媒体。
注意
仅移动客户端支持海报 URL。
选择 “保存” ,然后选择“ 向我发送此卡片”。
包含媒体文件的自适应卡片已成功保存并发送到 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 |