Compartilhar via


Visão geral dos Cartões Adaptáveis

Os Cartões Adaptáveis são formatos de troca de cartões aberto que permitem aos desenvolvedores trocar o conteúdo da interface do usuário de maneira comum e consistente.

Como eles funcionam

Autores de cartão descrevem seu conteúdo como um objeto JSON simples. Esse conteúdo, em seguida, pode ser renderizado nativamente dentro de um Aplicativo host, adaptando-se automaticamente à aparência e à funcionalidade do host.

Por exemplo, o Bot da Contoso pode criar um cartão adaptável por meio da Bot Framework e, quando ele for entregue ao Skype, terá aparência e funcionamento semelhantes aos de um cartão do Skype. Quando essa mesma carga for enviada ao Microsoft Teams, ela terá aparência e funcionamento semelhantes aos do Microsoft Teams. Conforme mais aplicativos host começarem a dar suporte a Cartões Adaptáveis, essa mesma carga acenderá automaticamente dentro desses aplicativos, mas ainda parecerá totalmente nativa para o aplicativo.

Os usuários se beneficiam porque tudo parece familiar. Os aplicativos host se beneficiam porque eles controlam a experiência do usuário. E Autores de Cartão se beneficiam porque seu conteúdo obtém alcance mais amplo, sem nenhum trabalho adicional.

Metas

As metas para os Cartões Adaptáveis são:

  • Portátil – para qualquer aplicativo, dispositivo e estrutura de interface do usuário
  • Aberto – as bibliotecas e o esquema são de software livre e compartilhados
  • Baixo custo – fácil de definir, fácil de usar
  • Expressivo – destinado à longa cauda de conteúdo que os desenvolvedores desejam produzir
  • Puramente declarativo – nenhum código é necessário ou permitido
  • Automaticamente estilizado – para as diretrizes de marca e a experiência do usuário do aplicativo host

Para autores de cartão

Os cartões adaptáveis são ótimos para autores de cartão:

  • Um esquema – obter um único formato, minimizando o custo de criação de um cartão e maximizando o número de locais onde ele pode ser usado.
  • Expressão mais completa – seu conteúdo pode ficar mais alinhado com o que você deseja dizer, porque você tem mais recursos disponíveis.
  • Amplo alcance – seu conteúdo funcionará em um conjunto mais amplo de aplicativos sem a necessidade de aprender novos esquemas.
  • Controles de entrada – seu cartão pode incluir controles de entrada para a coleta de informações do usuário que está exibindo o cartão.
  • Ferramentas melhores – um ecossistema de cartão aberto significa melhores ferramentas sendo compartilhadas por todos.

Para os proprietários de experiência

Se você for um desenvolvedor de aplicativo que deseja aproveitar um ecossistema de conteúdo de terceiros, você vai adorar os Cartões Adaptáveis porque:

  • Experiência do usuário consistente – por ser proprietário do estilo do cartão renderizado, você assegura uma experiência consistente para seus usuários.
  • Desempenho nativo – você obtém desempenho nativo, pois ele se destina diretamente à estrutura de interface do usuário.
  • Segurança – o conteúdo é entregue em cargas seguras para que você não precise abrir sua estrutura de interface do usuário para marcação bruta e scripts.
  • Fácil de implementar – você pode abandonar as bibliotecas de prateleira para integrar facilmente em qualquer plataforma à qual você dá suporte
  • Documentação gratuita – você poupa tempo porque não precisa inventar, implementar e documentar um esquema proprietário.
  • Ferramentas compartilhadas – você poupa tempo porque não precisa criar ferramentas personalizadas.

Princípios de design essenciais

Os Cartões Adaptáveis são controlados por um conjunto de princípios básicos que têm sido úteis para manter o design no caminho certo.

Semântica em vez de pixel perfeito

Nos esforçamos ao máximo para obtermos conceitos e valores semânticos em vez de layout de pixel perfeito puro. Exemplos de expressão semântica aparecem em cores, tamanhos e em elementos como FactSet e ImageSet. Todos eles permitem que o aplicativo host tome decisões melhores sobre a aparência e a experiência reais.

O conteúdo pertence aos autores do cartão, enquanto a aparência e a experiência pertencem ao aplicativo host

Os autores do cartão são proprietários do que desejam dizer, mas o aplicativo que exibe esse cartão é proprietário da aparência e da experiência do cartão no contexto do aplicativo deles.

Mantenha-o simples, mas expressivo

Queremos que os Cartões Adaptáveis sejam de uso geral e expressivos, mas não queremos criar uma estrutura de interface do usuário. A meta é criar uma camada intermediária que é "suficientemente expressiva", da mesma forma que o Markdown é suficientemente expressivo para documentos.

Ao concentrar-se em mantê-lo simples e expressivo, o Markdown criou uma descrição simples e consistente do conteúdo do documento. Da mesma forma, acreditamos que os Cartões Adaptáveis podem criar um meio simples e expressivo de descrever o conteúdo do cartão.

Em caso de dúvida, deixe fora

É mais fácil adicionar mais tarde do que viver com um erro. Se começarmos a debater sobre adicionar algo ou não, optaremos por deixar isso de fora. Sempre é mais fácil adicionar uma propriedade do que lidar com algo herdado cujo suporte é complicado.

Sessão do Build 2019

A sessão a seguir, apresentada na conferência Microsoft Build, mostra Cartões Adaptáveis em vários casos de uso.

[!VÍDEO [https://www.youtube.com/embed/wT1yFr_j6IM]