您可以輕鬆地在應用程式中轉譯調適型卡片。 我們提供所有通用平臺的 SDK，並提供建立您自己的調適型卡片轉譯器 的詳細規格 。
- 安裝轉譯器 SDK - 適用於您的目標平臺。
- 建立轉譯器實例 - 使用您應用程式的樣式、規則和動作事件處理程式進行設定。
- 將卡片轉譯為原生 UI - 自動設定樣式至您的應用程式。
調適型卡片 SDK
| 平台 | 安裝 | 建造 | 文檔 | 地位 |
|---|---|---|---|---|
| JavaScript |
|
來源 | 文件 |
|
| .NET WPF |
|
來源 | 文件 |
|
| .NET HTML |
|
來源 | 文件 |
|
| Windows UWP |
|
來源 | 文件 |
|
| WinUI 3 |
|
來源 | 文件 |
|
| Android |
|
來源 | 文件 |
|
| iOS |
|
來源 | 文件 |
|
建立轉譯器的實例
下一個步驟是建立AdaptiveCardRenderer實例。
連結動作事件
預設情況下，這些動作會呈現為卡片上的按鈕，但需要由您的應用程式來確保它們按照預期進行行為。 每個 SDK 都有一個等價的 OnAction 事件，您必須處理。
-
Action.OpenUrl - 開啟指定的
url。 - Action.Submit - 取得送出的結果，並將其傳送至來源。 如何將它傳送至卡片的來源完全由您決定。
-
Action.ShowCard - 叫用對話框，並將子卡片轉譯至該對話。 請注意，只有在
ShowCardActionMode設定為popup的情況下才需要處理。
渲染卡片
取得卡片內容之後，只需呼叫渲染器並傳入卡片即可。 您將取得由卡片內容組成的原生 UI 物件。 現在，請將此 UI 放在應用程式中的某個位置。
個性化
有數種方式可以自定義轉譯的內容。
主機配置
HostConfig 是共用的跨平台組態物件，可控制應用程式內卡片的基本樣式和行為。 它會定義字型大小、元素之間的間距、色彩、支援的動作數目等專案。
原生平台樣式
大部分的UI架構可讓您使用原生UI架構樣式來設定轉譯卡片的樣式。 例如，在 HTML 中，您可以指定 HTML 的 CSS 類別，或在 XAML 中，您可以傳入自定義 ResourceDictionary，以精細控制輸出。
自訂每個元素的渲染
每個 SDK 都可讓您覆寫任何元素的渲染，甚至新增支援您所定義的全新元素。 例如，您可以變更 Input.Date 轉譯器以發出自己的自定義控件，同時仍保留轉譯器的其餘輸出。 或者，您可以新增您定義的自訂 Rating 元素支援。