可以轻松地在应用程序中呈现自适应卡片。 我们为所有通用平台提供 SDK，并提供创建自己的自适应卡片呈现器 的详细规范 。
- 为目标平台安装呈现器 SDK。
- 创建呈现器实例 - 使用应用的样式、规则和作事件处理程序进行配置。
- 将卡片呈现到本机 UI - 自动设置为应用样式。
自适应卡片软件开发工具包
| 平台 | 安装 | 建造 | 文档 | 状态 |
|---|---|---|---|---|
| JavaScript |
|
来源 | 文档 |
|
| .NET WPF |
|
来源 | 文档 |
|
| .NET HTML |
|
来源 | 文档 |
|
| Windows UWP |
|
来源 | 文档 |
|
| WinUI 3 |
|
来源 | 文档 |
|
| Android |
|
来源 | 文档 |
|
| iOS |
|
来源 | 文档 |
|
创建呈现器实例
下一步是创建实例 AdaptiveCardRenderer。
连接动作事件
默认情况下，这些操作将以卡片上的按钮形式呈现，但由你的应用来确保其按预期运行。 每个 SDK 都具有一个等效的 OnAction 事件，必须处理。
-
Action.OpenUrl - 打开指定的
url。 - Action.Submit - 获取提交的结果并将其发送到源。 如何将其发送到卡片来源完全取决于您。
-
Action.ShowCard - 调用对话并将子卡呈现到该对话框中。 请注意，仅当
ShowCardActionMode设置为popup时才需要处理此问题。
渲染卡片
获取卡片有效负载后，只需调用renderer并传入卡片。 你将返回由卡片内容构成的本机 UI 对象。 现在，请将此 UI 放在应用中的某个位置。
自定义
可通过多种方式自定义呈现的内容。
主机配置
HostConfig 是一个共享的跨平台配置对象，用于控制应用内卡片的基本样式和行为。 它定义字体大小、元素间距、颜色、支持作数等内容。
原生平台样式
大多数 UI 框架允许您使用原生 UI 框架的样式来设置呈现的卡片的样式。 例如，在 HTML 中，可以为 HTML 指定 CSS 类，也可以在 XAML 中传入自定义 ResourceDictionary，以便对输出进行精细控制。
自定义每个元素渲染
每个 SDK 都允许您重写任何元素的呈现，甚至可以添加对您自定义的新元素的支持。 例如，可以更改 Input.Date 呈现器以发出自己的自定义控件，同时仍保留呈现器输出的其余部分。 或者，可以添加对定义的自定义 Rating 元素的支持。