Práticas recomendadas de atividades do usuário

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

Quando criar ou atualizar atividades do usuário

Como cada aplicativo é diferente, cabe a cada desenvolvedor determinar a melhor maneira de mapear ações dentro do aplicativo para as Atividades do Usuário. As Atividades do 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.

Diretrizes gerais

• Registre uma única atividade para um grupo de ações de usuário relacionadas. Isso é especialmente relevante para playlists 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 de usuário com vários itens de histórico que representam 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 dados do usuário na nuvem. Se você quiser dar suporte a atividades entre dispositivos, precisará garantir que o conteúdo necessário para reengajar essa atividade seja armazenado em um local de nuvem. Atividades específicas do dispositivo aparecerão na Linha do Tempo no dispositivo em que 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 aplicativo for usado para concluir operações simples e pontuais 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á-la em seu aplicativo, você não deverá criar uma Atividade para isso. Esse tipo de ação é melhor atendido pelas Notificações da Central de Ações.
  • Cenários de colaboração são uma exceção: se vários usuários estiverem trabalhando juntos na mesma atividade (como um documento do Word), haverá casos em que outro usuário fez alterações depois do seu usuário. Nesse caso, talvez você queira atualizar a Atividade existente para refletir as alterações feitas no documento. Isso envolveria a atualização dos dados de conteúdo da 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 – criar uma atividade por documento, com um ou mais itens de histórico refletindo os períodos de uso. É importante atualizar sua Atividade conforme as alterações são feitas no documento.
• Jogos – Crie uma Atividade para cada salvamento ou mundo do jogo. Se o jogo der suporte apenas a uma única sequência de níveis, você poderá publicar novamente a mesma Atividade ao longo do tempo, embora queira atualizar os dados de conteúdo para mostrar o progresso ou as conquistas mais recentes.
• Aplicativos Utilitários — Se não houver nada no seu aplicativo que os usuários precisem sair e retomar, você não precisará usar as Atividades de Usuário. Um bom exemplo é um aplicativo simples como Calculadora.
• Aplicativos de linha de negócios — existem muitos aplicativos 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, relatórios de despesas seriam cada 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 – criar uma atividade por agrupamento lógico de conteúdo (como uma playlist, um programa ou um 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 autônomo 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 será a atividade. Se eles optarem por reproduzir um único item de conteúdo, esse item de conteúdo atuará como a atividade. Veja mais diretrizes específicas abaixo.
  • Música: Álbum/Artista/Gênero – se o usuário selecionar um Álbum, Artista ou Gênero e apertar tocar, essa coleção constitui a atividade; não escreva uma Atividade separada para cada canção. 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 de um álbum ou playlist, registrar sua posição dentro do álbum pode fazer sentido.
  • Música: playlists inteligentes — aplicativos que reproduzem música em uma ordem aleatória devem gravar uma única Atividade para essa playlist. Se o usuário tocar a playlist uma segunda vez, você criará registros de histórico adicionais para a mesma Atividade. Não é necessário gravar a posição atual do usuário na playlist porque a ordenação é aleatória.
  • série de TV — se o aplicativo estiver configurado para reproduzir o próximo episódio após a conclusão da atual, você deverá escrever uma única Atividade para a série de TV. Ao reproduzir os vários episódios em várias sessões de exibição, você atualizará sua Atividade para refletir a posição atual da série e vários registros de histórico serão criados.
  • Filme – Um filme é um único conteúdo e deve ter seu próprio registro histórico. Se o usuário parar de assistir ao filme no meio do caminho, é desejável registrar sua posição. Quando quiser retomá-lo no futuro, a Atividade poderá retomar o filme de onde parou ou até mesmo perguntar ao usuário se ele 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 tomam 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 tratados pelo aplicativo. Consulte a seção Manipulação de 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 de Cartão Adaptável), permitem que os usuários identifiquem visualmente uma Atividade. Veja abaixo as diretrizes sobre como criar visuais de Cartão Adaptável 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, isso assume a forma de dados http://schema.org. Veja abaixo as diretrizes sobre como preencher esses dados.

Diretrizes de design do Cartão Adaptável

Quando as atividades aparecem na Linha do Tempo, elas são exibidas usando a estrutura de Cartões Adaptáveis . 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 necessá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 de Cartões Adaptáveis para obter instruções técnicas sobre como construir objetos de Cartão Adaptável. Consulte as diretrizes abaixo para criar Cartões Adaptáveis nas Atividades do Usuário.

• Usar imagens
  • Use uma imagem exclusiva para cada Atividade, se possível. O nome e o ícone do aplicativo serão exibidos automaticamente ao lado do cartão da Atividade; imagens adicionais ajudarão os usuários a localizar a atividade que estão procurando.
  • As imagens não devem incluir o texto que o usuário deve ler. Este texto não estará disponível para usuários com necessidades de acessibilidade e não poderá ser pesquisado.
  • Se a imagem não contiver texto e puder ser cortada para cerca de uma taxa de 2:1, você deverá usá-la como uma imagem de plano de fundo. Isso resulta em um cartão de atividade destacado que se sobressairá na Timeline. A imagem será escureada ligeiramente para garantir que o texto permaneça visível no cartão e você será incentivado a usar apenas o Nome da Atividade nesse caso, pois um texto menor pode se tornar difícil de ler.
  • Se a imagem não puder ser cortada para 2:1, você deverá colocá-la no Cartão de Atividade.
    • Se a proporção de aspecto for Quadrado ou Retrato, fixe a imagem no lado direito do cartão, encostando 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 de Atividade, que sempre deve ser mostrado.
  • 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 Linha do Tempo torna mais fácil para os usuários procurar 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 aplicativo na Linha do Tempo.
  • Por exemplo, as atividades devem usar a mesma cor da tela de fundo.
• Use informações de texto complementares com moderação.
  • Evite preencher o cartão com texto e use apenas informações complementares que ajudam os usuários a encontrar a atividade certa ou reflete 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. Em seguida, 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 produto específico em diferentes aplicativos e sites). É uma boa ideia representar os substantivos e os verbos envolvidos em uma atividade.

No exemplo a seguir, o JSON de metadados de conteúdo, que segue os padrões de Schema.org, representa 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"
  }
}

APIs de chave

• Namespace de UserActivities

Tópicos relacionados

• Atividades do Usuário (documentos do Project Rome)
• Cartões adaptativos
• Visualizador de Cartões Adaptativos, Exemplos
• Gerenciar a ativação de URI
• Microsoft Graph