Práticas recomendadas de Atividades do Usuário

Este guia descreve as práticas recomendadas para criar e atualizar as Atividades do Usuário. Para obter uma visão geral do recurso Atividades do Usuário no Windows, consulte Continuar a atividade do usuário, mesmo entre dispositivos. Ou consulte a seção Atividades do Usuário do Projeto Roma para as implementações de Atividades em outras plataformas de desenvolvimento.

Quando criar ou atualizar as Atividades do Usuário

Como cada aplicativo é diferente, cabe a cada desenvolvedor determinar a melhor maneira de mapear ações dentro do aplicativo para Atividades do Usuário. Suas Atividades de Usuário serão exibidas na Cortana e na Linha do Tempo, que se concentram em aumentar a produtividade e a eficiência dos usuários, ajudando-os a voltar ao conteúdo que visitaram no passado.

Orientações gerais

• Registre uma única atividade para um grupo de ações de usuário relacionadas. Isso é especialmente relevante para listas de reprodução de música ou programas de TV: uma única atividade pode ser atualizada em intervalos regulares para refletir o progresso do usuário. Nesse caso, você terá uma única Atividade do Usuário com vários Itens do Histórico representando períodos de envolvimento em vários dias ou semanas. O mesmo se aplica a atividades baseadas em documentos nas quais o usuário faz progressos graduais em seu aplicativo.
• Armazene os dados do usuário na nuvem. Se quiser dar suporte a Atividades entre dispositivos, você precisará garantir que o conteúdo necessário para reativar essa Atividade seja armazenado em um local na nuvem. Atividades específicas do dispositivo aparecerão na Linha do tempo no dispositivo onde a atividade foi criada, mas podem não aparecer em outros dispositivos.
• Não crie Atividades para ações que os usuários não precisarão retomar. Se o seu aplicativo for usado para concluir operações simples e únicas que não persistem o status, você provavelmente não precisará criar uma Atividade do Usuário.
• Não crie Atividades para ações concluídas por outros usuários. Se uma conta externa enviar uma mensagem ao usuário ou @-mencioná-los em seu aplicativo, você não deve criar uma atividade para isso. Esse tipo de ação é melhor atendido pelas Notificações da Central de Ações.
  • Os cenários de colaboração são uma exceção: se vários utilizadores estiverem a trabalhar juntos na mesma atividade (como um documento do Word), haverá casos em que outro utilizador fez alterações após o seu utilizador. Nesse caso, convém atualizar a atividade existente para refletir as alterações feitas no documento. Isso envolveria a atualização dos dados de conteúdo de atividade do usuário existentes sem criar um novo item de histórico.

Diretrizes para tipos específicos de aplicativos

Embora cada aplicativo seja diferente, a maioria dos aplicativos se enquadrará em um dos seguintes padrões de interação.

• Aplicativos baseados em documentos — Crie uma atividade por documento, com um ou mais itens de histórico refletindo períodos de uso. É importante atualizar a sua Atividade à medida que são feitas alterações ao documento.
• Jogos — Crie uma Atividade para cada save de jogo ou mundo. Se o teu jogo suportar apenas uma única sequência de níveis, podes voltar a publicar a mesma Atividade ao longo do tempo, embora possas querer atualizar os dados de conteúdo para mostrar o progresso ou conquistas mais recentes.
• aplicativos utilitários — Se não houver nada em seu aplicativo que os usuários precisem sair e retomar, você não precisará usar Atividades do usuário. Um bom exemplo é um aplicativo simples como a Calculadora.
• Aplicativos de linha de negócios — Muitos aplicativos existem para gerenciar tarefas ou fluxos de trabalho simples. Crie uma atividade para cada fluxo de trabalho separado acessado por meio de seu aplicativo (por exemplo, os relatórios de despesas seriam cada um uma Atividade separada, para que o usuário pudesse clicar em uma Atividade para ver se um relatório específico foi aprovado).
• Aplicativos de reprodução de mídia — Crie uma atividade por agrupamento lógico de conteúdo (como uma lista de reprodução, programa ou conteúdo autônomo). A questão subjacente para os desenvolvedores de aplicativos é se cada parte do conteúdo (episódio de TV, música) conta como conteúdo independente ou parte de uma coleção. Como regra geral, se o usuário optar por reproduzir uma coleção ou conteúdo sequencial, a coleção como um todo é a atividade. Se eles optarem por reproduzir um único conteúdo, então esse conteúdo é a atividade. Veja orientações mais específicas abaixo.
  • Música: Álbum/Artista/Gênero — Se o usuário selecionar um Álbum, Artista ou Gênero e pressionar reproduzir, essa coleção é a atividade; não escreva uma atividade separada para cada música. Para coleções curtas, como um único álbum ou coleções sendo reproduzidas em uma ordem aleatória, talvez não seja necessário atualizar a Atividade para refletir a posição atual do usuário. Para uma reprodução sequencial longa, como um álbum ou uma lista de reprodução, gravar a sua posição dentro do álbum pode fazer sentido.
  • Música: listas de reprodução inteligentes — Os aplicativos que reproduzem música em uma ordem aleatória devem gravar uma única atividade para essa lista de reprodução. Se o utilizador reproduzir a lista de reprodução uma segunda vez, serão criados registros de histórico adicionais para a mesma atividade. Gravar a posição atual do usuário na lista de reprodução não é necessário porque a ordem é aleatória.
  • série de TV — Se seu aplicativo estiver configurado para reproduzir o próximo episódio após a conclusão do atual, você deverá escrever uma única atividade para a série de TV. À medida que assiste aos vários episódios em múltiplas sessões de visualização, irá atualizar a sua Atividade para refletir a posição atual na série, e serão criados vários registos históricos.
  • Movie — Um filme é uma peça única de conteúdo e deve ter o seu próprio registo histórico. Se o usuário parar de assistir ao filme no meio do caminho, é desejável gravar sua posição. Quando desejarem retomá-lo no futuro, a Atividade poderá retomar o filme de onde parou, ou até mesmo perguntar ao usuário se deseja retomar ou começar no início.

Design de atividade do usuário

As Atividades do Usuário consistem em três componentes: um URI de ativação, dados visuais e metadados de conteúdo.

• O URI de ativação é um URI que pode ser passado para um aplicativo ou experiência para retomar o aplicativo com um contexto específico. Normalmente, esses links assumem a forma de manipulador de protocolo para um esquema (por exemplo, "my-app://page2?action=edit"). Cabe ao desenvolvedor determinar como os parâmetros de URI serão manipulados por seu aplicativo. Consulte Processar a ativação de URI para obter mais informações.
• Os dados visuais, que consistem em um conjunto de propriedades obrigatórias e opcionais (por exemplo: título, descrição ou elementos Adaptive Card), permitem que os usuários identifiquem visualmente uma Atividade. Veja abaixo as diretrizes sobre como criar visuais do Adaptive Card para sua atividade.
• Os metadados de conteúdo são dados JSON que podem ser usados para agrupar e recuperar atividades em um contexto específico. Normalmente, isto assume a forma de dados do tipo http://schema.org. Veja abaixo as orientações sobre o preenchimento desses dados.

Diretrizes de design do cartão adaptável

Quando as Atividades aparecem na Linha do tempo, elas são exibidas usando a estrutura do Adaptive Card. Se o desenvolvedor não fornecer um Cartão adaptável para cada atividade, a Linha do tempo criará automaticamente um cartão simples com base no nome/ícone do aplicativo, no campo Título obrigatório e no campo Descrição opcional.

Os desenvolvedores de aplicativos são incentivados a fornecer cartões personalizados usando o esquema JSON de cartão adaptável simples. Consulte a documentação do Adaptive Cards para obter instruções técnicas sobre como construir objetos Adaptive Card. Consulte as orientações abaixo para projetar Cartões Adaptáveis em atividades de utilizador.

• Utilizar imagens
  • Use uma imagem exclusiva para cada Atividade, se possível. O nome e o ícone do seu aplicativo serão exibidos automaticamente ao lado do cartão da sua Atividade; imagens adicionais ajudarão os usuários a localizar a atividade que estão procurando.
  • As imagens não devem incluir texto que se espera que o utilizador leia. Este texto não estará disponível para utilizadores com necessidades de acessibilidade e não pode ser pesquisado.
  • Se a imagem não contiver texto e puder ser cortada para uma proporção de 2:1, você deve usá-la como uma imagem de fundo. Isto resulta num cartão de atividade destacado que se destacará na cronologia. A imagem será ligeiramente escurecida para garantir que o texto permaneça visível no cartão, e você é encorajado a usar apenas o Nome da atividade neste caso, pois o texto menor pode se tornar difícil de ler.
  • Se a imagem não puder ser cortada para 2:1, você deve colocá-la dentro do Cartão de Atividade.
    • Se a proporção for Quadrado ou Retrato, fixe a imagem no lado direito do cartão sem margens.
    • Se a proporção for Paisagem, ancore a imagem no canto superior direito do cartão.
• É necessário que cada atividade forneça um Nome da Atividade, que deve ser sempre exibido.
  • Esse nome deve ser exibido no canto superior esquerdo do cartão usando a opção de texto em negrito grande. É importante que o nome seja facilmente reconhecível, pois essa é a única parte que os usuários verão quando a atividade for mostrada em cenários da Cortana. Mostrar o mesmo nome na cronologia facilita a navegação dos utilizadores por um grande número de atividades.
• Use o mesmo estilo visual para todas as Atividades do seu aplicativo, para que os usuários possam localizar facilmente as atividades do seu aplicativo na Linha do tempo.
  • Por exemplo, todas as Atividades devem usar a mesma cor de plano de fundo.
• Use informações de texto suplementares com moderação.
  • Evite preencher o cartão com texto e use apenas informações suplementares que ajudem os usuários a encontrar a atividade certa ou reflitam informações de estado (como o progresso atual em uma tarefa específica).

Diretrizes de metadados de conteúdo

As Atividades do Usuário também podem conter metadados de conteúdo, que o Windows e a Cortana usam para categorizar Atividades e gerar inferências. As atividades podem ser agrupadas em torno de um tópico específico, como um local (se o usuário estiver pesquisando férias), objeto (se o usuário estiver pesquisando algo) ou ação (se o usuário estiver comprando um determinado produto em diferentes aplicativos e sites). É uma boa ideia representar tanto os substantivos quanto os verbos envolvidos em uma atividade.

No exemplo a seguir, os metadados de conteúdo JSON, seguindo os padrões de Schema.org, representam o cenário: "John jogou Angry Birds com Steve."

// John played angry birds with Steve.
{
  "@context": "http://schema.org",
  "@type": "PlayAction",
  "agent": {
    "@type": "Person",
    "name": "John"
  },
  "object": {
    "@type": "MobileApplication",
    "name": "Angry Birds."
  },
  "participant": {
    "@type": "Person",
    "name": "Steve"
  }
}

Principais APIs

• de namespace UserActivities

Tópicos relacionados

• Atividades do Usuário (documentos do Projeto Roma)
• Cartões adaptáveis
• Visualizador de cartões adaptativos, exemplos
• Gerir a ativação de URI
• Gráfico da Microsoft