Sdílet prostřednictvím


Přehled adaptivních karet

Poznámka:

Vytváříte scénáře Copilotu, Teams nebo Outlooku s využitím adaptivních karet? Navštivte Adaptive Card Documentation Hub, nové jednotné kontaktní místo pro všechny vaše potřeby adaptivních karet! Obsahuje všechny prostředky, které hledáte, včetně kompletní dokumentace pro řadu nových funkcí, jako je responzivní rozložení, ikona, odznáček, karusely, grafy a mnoho dalšího.

Adaptivní karty jsou otevřený formát výměny karet, který umožňuje vývojářům vyměňovat si obsah uživatelského rozhraní běžným a konzistentním způsobem.

Zcela nový způsob doručování uživatelského rozhraní: Adaptivní karty jsou fragmenty uživatelského rozhraní nezávislé na platformě vytvořené ve formátu JSON, které můžou aplikace a služby otevřít. Při doručení do konkrétní aplikace se JSON transformuje do nativního uživatelského rozhraní, které se automaticky přizpůsobí jeho okolí. Pomáhá navrhovat a integrovat lehké uživatelské rozhraní pro všechny hlavní platformy a architektury.

Adaptivní karty jsou určené pro:

Seznamte se s uživateli, kde jsou

Moderní digitální život je hektický. Uživatelé neustále přepínají mezi zařízeními, aplikacemi a službami, aby se jejich práce dokončila. Adaptivní karty pomáhají zvýšit zapojení a efektivitu tím, že přímo do aplikací, které používají každý den, vkládají interaktivní obsah.

Integrace do stávajících aplikací:

  • Adaptivní karty Teams: Jako digitální centrum pro mnoho moderních pracovníků nabízí Teams několik rozšiřitelných bodů pro integraci aplikací. Konverzační agent využívající adaptivní karty může výrazně zjednodušit obchodní pracovní postupy na vašem webu nebo prostřednictvím jiných kanálů.
  • Zprávy s akčními prvky Outlooku: E-mail už dlouho je hlavní součástí pracovníků v oblasti informací a teď můžete doručovat akční obsah přímo do jejich složky Doručená pošta.
  • Časová osa Windows: Pomozte uživatelům pokračovat v jejich aktivitách na jakémkoli zařízení.

Otevření aplikací pro rozšiřitelnost

Existuje ekosystém vývojářů, kteří chtějí integrovat do vašich aplikací, ale jak to můžete udělat bezpečně a bez toho, aby jejich obsah nevyčníval? Adaptivní karty jsou vždy nativní a bezproblémově se prolínají s okolním uživatelským rozhraním – a fungují na každé hlavní platformě!

Instalace vykreslovacích sad SDK >

  • Nativní výkon: Adaptivní karty vykreslují nativní uživatelské rozhraní na libovolné platformě.
  • Přizpůsobí se okolnímu uživatelskému rozhraní: Karty se automaticky přizpůsobí okolnímu uživatelskému rozhraní.
  • Plně rozšiřitelné: Schéma je otevřené, takže můžete přidat vlastní prvek.
  • Dynamická a interaktivní: Interaktivita se vyjadřuje deklarativním způsobem, aby se snížilo riziko injektáže vlastního kódu.

Návrhové karty kdekoli

Nemusíte posílat své uživatele na tento web, aby navrhovali karty. Stejně jako adaptivní karty splývají se svým okolím, splývá i návrhář adaptivních karet. Sada SDK obsahuje úplné rozhraní API konfigurace, které umožňuje hlubokou integraci pracovních postupů karet do existující sady nástrojů.

Instalace sady Designer SDK >

Vytváření, sdílení a zjišťování opakovaně použitelných šablon

Co když byste mohli okamžitě zobrazit nějaký typ dat? Může to být data vaší vlastní aplikace, data vaší organizace nebo data z webu. Díky adaptivnímu vytváření šablon karet můžete data oddělit od rozložení karet a ve spojení s novou službou šablon se otevírá zcela nový ekosystém pro výměnu karet.

Vytváření opakovaně použitelných šablon karet >

  • Bohatá integrace návrháře: Ukázková data vám umožní zobrazit náhled šablony bez opuštění návrhového prostředí.
  • Zjednodušení vývojových pracovních postupů: Vytvořte šablonu v návrháři, použijte ji bez služeb a vložte ji zpět do návrháře a proveďte změny.
  • Zjišťování a sdílení šablon pomocí služby REST: Služba šablony najde šablonu pro vaše data a dokonce ji naplní za vás.
  • Chceme od vás slyšet: Zatím nemáme datum vydání této verze Preview, ale čekáme na to, abychom se od vás naučili.

Jak fungují

Autoři karet popisují jejich obsah jako jednoduchý objekt JSON. Tento obsah se pak dá nativně vykreslit uvnitř hostitelské aplikace a automaticky se přizpůsobit vzhledu a chování hostitele.

Contoso Bot může například vytvořit adaptivní kartu prostřednictvím služby Bot Framework a při doručení do Skypu bude vypadat jako karta Skypu. Když se do Microsoft Teams odešle stejný payload, bude vypadat a působit jako Microsoft Teams. Protože více hostitelských aplikací začne podporovat adaptivní karty, stejný uživatelský obsah se automaticky zobrazí uvnitř těchto aplikací, ale stále bude působit zcela přirozeně v prostředí aplikace.

Uživatelé vyhrávají, protože všechno působí povědomě. Hostitelské aplikace vyhrávají, protože řídí uživatelský zážitek. A autoři karet vítězí, protože jejich obsah má širší dosah, a to bez další práce.

Cíle

Mezi cíle adaptivních karet patří:

  • Přenosná – do libovolné aplikace, zařízení a architektury uživatelského rozhraní
  • Open – Knihovny a schéma jsou opensourcové a sdílené
  • Nízké náklady – snadno definovatelné, snadno použitelné
  • Expressive – cílí na dlouhý ocas obsahu, který chtějí vývojáři vytvořit
  • Čistě deklarativní – není potřeba ani není povolený žádný kód.
  • Automaticky stylovaný – podle pokynů pro uživatelské prostředí a značku hostitelské aplikace

Pro autory karet

Adaptivní karty jsou skvělé pro autory karet:

  • Jedno schéma – získáte jeden formát, minimalizujete náklady na vytvoření karty a maximalizujete počet míst, kde se dá použít.
  • Bohatší výraz – Obsah může lépe odpovídat tomu, co chcete říct, protože máte bohatší paletu, se kterou chcete malovat.
  • Široký dosah – Váš obsah bude fungovat v širší sadě aplikací, aniž byste se museli učit nová schémata.
  • Vstupní ovládací prvky – Karta může obsahovat vstupní ovládací prvky pro shromažďování informací od uživatele, který kartu zobrazuje.
  • Lepší nástroje – ekosystém otevřených karet znamená lepší nástroje, které sdílejí všichni.

Pro vlastníky zážitků

Pokud jste vývojář aplikací, který chce využít ekosystém obsahu třetích stran, budete rádi adaptivní karty, protože:

  • Konzistentní uživatelské prostředí – zaručujete konzistentní prostředí pro vaše uživatele, protože vlastníte styl vykreslené karty.
  • Nativní výkon – při přímém cílení na architekturu uživatelského rozhraní získáte nativní výkon.
  • Bezpečné – Obsah se dodává v bezpečných datových blocích, takže nemusíte otevírat architekturu uživatelského rozhraní pro nezpracovaný značkovací jazyk a skriptování.
  • Snadná implementace – máte k dispozici hotové knihovny pro snadnou integraci na jakoukoliv platformu, kterou podporujete.
  • Bezplatná dokumentace – ušetříte čas, protože nemusíte vynalézat, implementovat a dokumentovat proprietární schéma.
  • Sdílené nástroje – ušetříte čas, protože nemusíte vytvářet vlastní nástroje.

Základní principy návrhu

Adaptivní karty jsou řízeny sadou řídících principů, které byly užitečné pro udržení návrhu na správné cestě.

Sémantika místo pixelové dokonalosti

Usilovali jsme se co nejvíce dosáhnout sémantických hodnot a konceptů namísto čistě pixel-perfect rozložení. Příklady sémantických výrazů se zobrazují v barvách, velikostech a v prvech, jako jsou FactSet a ImageSet. Všechny tyto možnosti umožňují hostitelské aplikaci lépe rozhodovat o skutečném vzhledu a chování.

Autoři karet vlastní obsah, hostitelská aplikace vlastní vzhled a chování.

Autoři karet vlastní to, co chtějí říct, ale aplikace, která ji zobrazuje, vlastní vzhled a chování karty v kontextu aplikace.

Udržujte to jednoduché, ale výrazné

Chceme, aby adaptivní karty byly výrazné a obecné účely, ale nechceme vytvářet architekturu uživatelského rozhraní. Cílem je vytvořit zprostředkující vrstvu, která je "dostatečně výrazná", stejně jako Markdown je dostatečně výrazná pro dokumenty.

Když se zaměříme na to, aby byl jednoduchý a vyjádřitelný, Markdown vytvořil snadný a konzistentní popis obsahu dokumentu. Stejně se domníváme, že adaptivní karty můžou vytvořit jednoduchý, výrazný způsob popisu obsahu karet.

V případě pochybností to vynechejte

Je snazší přidat později, než žít s chybou. Pokud jsme se dostali do situace, kdy jsme debatovali, zda něco přidat nebo ne, rozhodli jsme se to vynechat. Vždy je jednodušší přidat vlastnost než žít se starými prvky, které bychom si přáli nemuseli podporovat.