備註
你正在建立由 Adaptive Cards 驅動的 Copilot、Teams 或 Outlook 應用場景嗎? 造訪 Adaptive Card Documentation Hub,這個全新的一站式平台,滿足您所有 Adaptive Card 的需求! 它擁有你所需的所有資源,包括許多新功能的完整文件,例如響應式版面、圖示、徽章、旋轉木馬、圖表等等!
調適型卡片是一種開放卡片交換格式,可讓開發人員以通用且一致的方式交換 UI 內容。
一種全新的介面交付方式:自適應卡片是平台無關的 UI 片段,以 JSON 撰寫,應用程式與服務可以公開交換。 當 JSON 交付到特定應用程式時,會轉換成原生介面,自動適應其環境。 它協助設計並整合所有主要平台與框架的輕量級使用者介面。
自適應卡適用於:
從用戶所在的位置與他們互動
現代數位生活非常忙碌。 使用者不斷在裝置、應用程式和服務間切換以完成工作。 Adaptive Cards 透過將可操作的內容直接注入他們每天使用的應用程式,幫助你提升互動與效率。
整合現有應用程式:
- Teams 自適應卡:作為許多現代員工的數位樞紐,Teams 提供多個擴充點供應用程式整合。 由 Adaptive Cards 驅動的對話式代理能大幅簡化您網站或其他管道上的業務工作流程。
- Outlook 可執行的訊息:電子郵件長期以來一直是資訊工作者的命脈,現在你可以直接將可執行的內容送達他們的收件匣。
- Windows 時間軸:協助使用者在任何裝置上恢復活動。
開放你的應用程式以具備延展性
外面有開發者的生態系統希望與你的應用程式進行整合,但你該如何安全地做到,並確保他們的內容不顯得格格不入? 自適應卡始終是原生的,能無縫融入周邊介面——而且它們在所有主要平台上都能運作!
- 原生效能:Adaptive Cards 能在任何平台上呈現原生介面。
- 能適應周遭介面:卡牌會自動適應周遭介面。
- 完全可擴充:這個結構是開放式的,讓你可以加入自己的元素。
- 動態且互動:互動性以宣告式表達,以降低自訂程式碼注入的風險
設計卡到處都有
你不必讓用戶到這個網站來設計卡片。 就像自適應卡會融入周遭環境一樣,自適應卡設計師也是如此。 SDK 包含完整的設定 API,讓你能將卡片工作流程深度整合進現有工具鏈中。
建立、分享並發現可重複使用的範本
如果你能即時顯示任何類型的資料呢? 可能是你自己的應用程式資料、組織的資料,或是來自網路的資料。 透過自適應卡片模板,你可以將資料與卡片佈局分離,結合新的範本服務,整個卡片交換生態系統就有可能實現。
- 豐富的設計器整合:範例資料讓你能在不離開設計器的情況下預覽範本。
- 簡化開發流程:在設計器中建立範本,不用服務使用,然後直接貼回設計器進行修改。
- 使用 REST 服務發現並分享範本:該範本服務會幫你找到資料的範本,甚至會幫你填入。
- 我們想聽聽你的意見:這次預覽尚未公布發行日期,但我們正等待你的消息。
其運作方式
卡片作者 將其內容描述為簡單的 JSON 物件。 然後,該內容可以在 主應用程式內原生轉譯,並自動適應主機的外觀和風格。
例如,Contoso Bot 可以透過 Bot Framework 撰寫調適型卡片,並在傳遞至 Skype 時,看起來和感覺就像 Skype 卡片。 當相同的承載傳送至 Microsoft Teams 時,其外觀和感覺就像Microsoft Teams。 隨著越來越多的主應用程式開始支援調適型卡片,相同的元素會自動在這些應用程式中啟用,但仍然感覺像是該應用程式的原生功能。
用戶獲勝,因為一切都感覺很熟悉。 主機應用程式會因為控制用戶體驗而獲勝。 卡片作者受益,因為他們的內容在不需要任何額外工作的情況下接觸到更廣大的群眾。
目標
調適型卡片的目標是:
- 通用 - 適用於任何應用程式、裝置和 UI 架構
- Open - 連結庫和架構為開放原始碼並共用
- 低成本 - 易於定義,容易取用
- Expressive - 以開發人員想要產生的內容長尾為目標
- 純宣告式 - 不需要或允許任何程序代碼
- 自動套用樣式 - 符合主應用程式的 UX 和品牌指南
卡片作者
Adaptive Cards 對卡片作者來說是很好的:
- 一個架構 - 您會取得單一格式,將建立卡片的成本降至最低,並將可使用的位置數目最大化。
- 更豐富的表達式 - 您的內容可以更緊密地配合您想要說的內容,因為您有更豐富的調色盤來繪製。
- 廣泛觸達 - 您的內容將可跨一組更廣泛的應用程式運作,而不需要學習新的架構。
- 輸入控制項 - 您的卡片可以包含輸入控制項,以便從檢視卡片的使用者收集資訊。
- 更好的工具 - 開放式卡片生態系統意味著每個人都共用的更好工具。
針對體驗擁有者
如果您是想要利用第三方內容生態系統的應用程式開發人員,您會喜歡調適型卡片,因為:
- 一致的用戶體驗 - 您能保證使用者擁有一致的體驗,因為您能掌控卡面呈現的樣式。
- 原生效能 - 由於是直接以您的 UI 架構為目標,您能獲得原生效能。
- 安全 - 內容會在安全承載中傳遞,因此您不需要將 UI 架構開啟為原始標記和腳本。
- 易於實作 - 您可以使用現成的程式庫,輕鬆地在支援的任一平臺上進行整合
- 免費檔 - 您不需要發明、實作及記錄專屬架構,因此可節省時間。
- 共用工具 - 您不需要建立自訂工具,因此可節省時間。
核心設計原則
調適型卡片是由一組 指導準則 所驅動,這些原則對於讓設計保持正軌很有用。
語意化而非像素完美
我們盡量爭取語義和概念,而不是僅僅追求像素完美的版面配置。 語意表達式的範例會以色彩、大小和 FactSet 和 ImageSet 等元素顯示。 這些都讓主應用程式能夠更妥善地決定實際的外觀和風格。
卡片作者擁有內容,主機應用程式擁有外觀和風格
卡片作者擁有表達內容的主導權,但在應用程式中的外觀和風格由顯示它的應用程式決定。
保持簡單,但具表現力
我們希望調適型卡片具有表達性和一般用途,但我們不想建置UI架構。 目標是建立一個中繼層,其表達能力應像 Markdown 對文件的表達能力一樣充足。
Markdown 專注於保持簡單且具表達性,建立文件內容的簡單且一致的描述。 同樣地,我們相信調適型卡片可以建立簡單的表達方式來描述卡片內容。
當有疑問時,請將其排除在外
後來添加比承受錯誤要容易得多。 如果我們發現自己在辯論我們是否應該加入一些東西,我們選擇將其排除在外。新增屬性總是比使用我們希望我們不需要支援的舊版更輕鬆。