Pessoas e conversas

A iniciativa de pessoas e conversas existe há vários anos no Android e tem como objetivo destacar pessoas e conversas na superfície do sistema do smartphone. Essa prioridade é baseada no fato de que a comunicação e a interação com outras pessoas ainda são a área funcional mais valiosa e importante para a maioria dos nossos usuários em todas as regiões demográficas.

Vários recursos foram lançados no Android 11 para apoiar a iniciativa de pessoas e conversas.

Espaço de conversa

Em muitos smartphones, há uma seção separada na parte superior da aba de notificações que contém apenas conversas com pessoas em tempo real, como chamadas e mensagens de chat, incluindo chats em grupo. As notificações nesse espaço têm uma aparência e um funcionamento diferente das notificações normais em muitos smartphones:

• O design é diferente, com forte ênfase no avatar que representa as pessoas, combinado com o app em que acontece a conversa.
• Um toque na notificação abre a conversa no app, ou no balão, se a conversa já tiver sido iniciada. Um toque no cursor de texto expande as novas mensagens da aba, exibindo todo o conteúdo com a lista completa de opções.
• Ações específicas de conversa são oferecidas, algumas ao tocar nelas e mantê-las pressionadas:
  • marcar esta conversa como prioritária;
  • promover esta conversa para o balão (exibido somente se o app for compatível com balões);
  • silenciar notificações para esta conversa;
  • definir sons ou vibrações personalizados para esta conversa.

Conversas em balões

A partir do Android 11, balões podem ser iniciados pelas notificações na seção Conversas. Somente notificações com um atalho associado podem ser exibidas em um balão. As conversas marcadas como importantes ou acionadas no balão na aba de notificações aparecem automaticamente.

Atalhos de conversa

Os atalhos para as conversas aparecem na tela de início e ao lado dos atalhos de compartilhamento de longa duração na planilha de compartilhamento do sistema.

Diretrizes da API

Esta seção descreve as APIs para adicionar compatibilidade no seu app para o espaço fornecido pelo sistema que mostra pessoas e conversas.

Atalhos para conversas

Para participar dessa iniciativa voltada para conversas, os apps precisam fornecer ao sistema atalhos de longa duração. É altamente recomendável usar atalhos de compartilhamento de longa duração. Se necessário, é possível usar atalhos dinâmicos no Android 11, mas podemos remover essa opção no futuro.

Para publicar um atalho para a conversa, chame os métodos existentes de ShortcutManager: setDynamicShortcuts(), addDynamicShortcuts() ou pushDynamicShortcut(), que gerencia automaticamente o limite de atalhos para o desenvolvedor. Esse atalho precisa ser de longa duração e ter dados de Person anexados de uma ou mais pessoas, identificando os outros participantes da conversa. Também recomendamos que você defina o LocusId para o atalho e anote as atividades no app e os fragmentos com LocusId. Isso ajuda o sistema a classificar as conversas de modo preciso com base no uso do app.

Se uma conversa não existir mais, o app poderá excluir o atalho com removeLongLivedShortcuts(). Isso faz com que o sistema exclua todos os dados associados à conversa. Embora os atalhos sejam removíveis, não é recomendado que os apps removam atalhos armazenados em cache, a menos que seja absolutamente necessário. Um atalho provavelmente está armazenado em cache porque o usuário interagiu para mudar a experiência dele, e a remoção desfaz essas mudanças, levando à frustração do usuário.

Notificações de conversa

Uma notificação será considerada uma notificação de conversa se o seguinte for verdadeiro:

• A notificação usa MessagingStyle.

• (Somente se o app for destinado ao Android 11 ou uma versão mais recente) A notificação está associada a um atalho válido de compartilhamento dinâmico ou em cache de longa duração. A notificação pode definir essa associação chamando setShortcutId() ou setShortcutInfo(). Se o app for direcionado ao Android 10 ou versões anteriores, a notificação não precisará ser associada a um atalho, conforme discutido na seção de opção de substituto.

• O usuário não rebaixou a conversa da seção de conversas pelas configurações do canal de notificação no momento da postagem.

Ajuda para classificar as conversas no app usando o LocusId

A inteligência no dispositivo determina as conversas que provavelmente serão mais interessantes para o usuário. Entre os sinais mais importantes estão o tempo para retorno e a frequência das sessões de cada conversa. O sistema reconhece as interações com uma conversa por atalhos da tela de início ou dentro de uma notificação, se elas forem marcadas corretamente. No entanto, o sistema não reconhece conversas que aconteceram totalmente no app, a menos que essas interações também estejam marcadas. Portanto, recomendamos que você anexe um LocusId ao atalho e anote a atividade ou o fragmento no app com o LocusId associado. O uso de LocusId permite que o sistema de sugestões classifique corretamente a conversa. Se você usar setShortcutInfo() para associar a conversa a um atalho, o sistema de conversas anexará automaticamente o LocusId adequado.

Requisitos de espaço de conversa para apps direcionados ao Android 10 ou versões anteriores

Mesmo que um app não seja direcionado ao Android 11, as mensagens dele ainda poderão ser exibidas no espaço de conversa. No entanto, o app ainda precisará atender a determinados requisitos. Esta seção descreve os requisitos desses apps e o comportamento substituto caso o app não atenda a eles.

O principal requisito para participação no espaço de mensagens é que o app precisa implementar notificações MessagingStyle, que precisam se referir a um atalho de longa duração publicado no momento em que a notificação é publicada. As notificações que atendem a esses requisitos aparecem no espaço de conversa com este comportamento:

• A notificação será exibida no estilo de conversa.
• O botão Balão é oferecido, se implementado.
• Funções específicas de conversa são oferecidas in-line.

Se a notificação não atender a esses requisitos, a plataforma usará opções de substituto para formatá-la. Se a notificação atender aos requisitos de um dos casos de substituto, ela será exibida no espaço de conversa com formatação especial. Se a notificação não se qualificar para uma das opções de substituto, ela não será exibida no espaço de conversa.

Substituto: se MessagingStyle for usado, mas nenhum atalho for fornecido

Se o app for destinado ao Android 10 ou versão anterior e uma notificação usar MessagingStyle, mas não associar a mensagem a um atalho, a notificação será mostrada no espaço de conversa com este comportamento:

• A notificação será exibida no estilo de conversa.
• Nenhum botão de balão será oferecido.
• Nenhuma função específica de conversa será oferecida in-line.

Substituto: se o MessagingStyle não for usado, mas o app for um app de mensagens reconhecido

Se uma notificação não usar MessagingStyle, mas o app for reconhecido pela plataforma como um app de mensagens, e o parâmetro category da notificação for definido como msg, a notificação será exibida no espaço de conversa com este comportamento:

• A notificação será exibida no antigo estilo, anterior ao do Android 11.
• Nenhum botão de balão será oferecido.
• Nenhuma função específica de conversa será oferecida in-line.

Orientação, uso e teste

Esta seção fornece orientações gerais sobre como usar e testar os recursos de conversa.

Quando devo usar as conversas?

As notificações de conversas e os atalhos relacionados visam melhorar a experiência do usuário em conversas em tempo real. Por exemplo, SMS, chats e chamadas telefônicas são conversas em tempo real em que os usuários esperam se comunicar rapidamente. Os usuários não têm essa expectativa com e-mails e atividades não relacionadas a conversas.

Os usuários poderão remover uma conversa da seção de conversa se não sentirem que ela está no espaço certo.

Como oferecer ótimos atalhos

Para ficar em destaque no espaço de conversa, você precisa oferecer atalhos caso seus apps sejam direcionados ao Android 11 ou versões mais recentes. Forneça um AdaptiveIconDrawable para o ícone do atalho. Caso contrário, seu avatar de atalho pode ser cortado acidentalmente. Consulte Como oferecer imagens de atalhos para ver mais detalhes.

Seu atalho será classificado em diferentes plataformas, incluindo a planilha de compartilhamento do sistema, se for um atalho de compartilhamento. Saiba mais sobre como conseguir a melhor classificação e ajudar o sistema a promover o atalho.

Como testar notificações e atalhos de conversa

Se você seguir as diretrizes, as conversas aparecerão automaticamente no espaço de conversa. É possível verificar se o atalho está integrado corretamente tocando na notificação e a mantendo pressionada. Se a integração for feita corretamente, a IU mostrará ações relacionadas à conversa. Se a notificação não estiver vinculada a um atalho, a IU mostrará um texto informando que o app não é compatível com os recursos de conversa.

Os atalhos adicionados são exibidos ao tocar na tela de início e mantê-la pressionada. Lembre-se de testar se os atalhos levam você ao lugar correto no seu app.

Os atalhos de compartilhamento adicionados são exibidos na linha de compartilhamento direto da planilha do sistema ao compartilhar conteúdo que seu atalho pode receber.