Guias em dispositivos móveis

Ao criar um aplicativo Microsoft Teams que inclui uma guia, você deve testar como sua guia funciona nos clientes do Microsoft Teams para Android e iOS. Este artigo descreve alguns dos principais cenários que você deve considerar para garantir a experiência ideal do usuário.

Os aplicativos publicados por meio da Microsoft Teams Store têm um processo de aprovação separado para clientes móveis. O comportamento padrão desses aplicativos é o seguinte:

Capacidade do aplicativo Comportamento se o aplicativo for aprovado Comportamento se o aplicativo não for aprovado
Guias pessoais O aplicativo aparece na barra inferior dos clientes móveis. As guias são abertas no cliente do Teams. O aplicativo não aparece na barra inferior dos clientes móveis.
Guias de canal e grupo A guia é aberta no cliente do Teams usando contentUrl. Se websiteUrl estiver disponível no arquivo de manifesto do aplicativo, a guia será aberta em um navegador fora do Teams.
Se websiteUrl não estiver disponível no arquivo de manifesto do aplicativo, a guia não estará acessível no Teams móvel. No entanto, a guia ainda está acessível na área de trabalho e na Web.

Observação

  • Os aplicativos enviados ao AppSource para publicação no Teams são avaliados automaticamente quanto à capacidade de resposta móvel. Em caso de dúvidas, entre em contato com teamsubm@microsoft.com.
  • Para todos os aplicativos que não são publicados por meio do AppSource, as guias são abertas em um modo de exibição da Web no aplicativo nos clientes do Teams por padrão e não é necessário um processo de aprovação separado.
  • O comportamento padrão dos aplicativos só é aplicável se publicado por meio da Teams Store. Por padrão, todas as guias são abertas no cliente do Teams.
  • Para iniciar uma avaliação do seu aplicativo para compatibilidade com dispositivos móveis, entre em contato teamsubm@microsoft.com com os detalhes do aplicativo.
  • Se um aplicativo móvel tiver várias guias, sempre que o usuário alternar uma guia, a guia não será recarregada.

Autenticação

Para que a autenticação funcione em clientes móveis, você deve atualizar sua biblioteca JavaScript do Teams para pelo menos a versão 1.4.1.

Baixa largura de banda e conexões intermitentes

Os clientes móveis funcionam com baixa largura de banda e conexões intermitentes. Seu aplicativo deve lidar com qualquer tempo limite adequadamente, fornecendo uma mensagem contextual ao usuário. Você também deve usar indicadores de progresso para fornecer comentários aos usuários sobre quaisquer processos de longa duração.

Teste em clientes móveis

Você deve validar se sua guia funciona corretamente em dispositivos móveis de vários tamanhos e qualidades. Para dispositivos Android, você pode usar o DevTools para depurar sua guia enquanto ela está em execução. É recomendável que você teste em dispositivos de alto e baixo desempenho, incluindo um tablet.

Publicar na Loja do Teams

Os aplicativos listados na Teams Store devem ser aprovados para uso móvel para funcionar corretamente no cliente móvel do Teams. A disponibilidade e o comportamento das guias dependem se o seu aplicativo foi aprovado.

Aplicativos na Loja do Teams aprovados para dispositivos móveis

A tabela a seguir descreve a disponibilidade e o comportamento da guia quando o aplicativo é listado no Teams Store e aprovado para uso móvel:

Recursos Disponibilidade móvel? Comportamento móvel
Canal
e guia grupo
Sim A guia é aberta no cliente móvel do Teams usando a configuração do contentUrl seu aplicativo.
Aplicativo pessoal Sim Cada guia na guia do aplicativo pessoal é aberta no cliente móvel do Teams usando sua respectiva contentUrl configuração.

Aplicativos na Loja do Teams não aprovados para dispositivos móveis

A tabela a seguir descreve a disponibilidade e o comportamento da guia quando o aplicativo está listado no Teams Store, mas não aprovado para uso móvel:

Recursos Disponibilidade móvel? Comportamento móvel
Guia Canal e grupo Sim A guia é aberta no navegador padrão do dispositivo em vez do cliente móvel do Teams usando a websiteUrl configuração do aplicativo, que também deve ser incluída na função do setSettings() código-fonte.
Aplicativo pessoal Não Não aplicável

Observação

  • As mensagens do bot são mostradas na seção de chat se um aplicativo móvel tiver os recursos de bot e guia.
  • Ao selecionar o Chat do aplicativo bot e selecionar Mais (...), você não poderá ver o recurso de guia desse aplicativo na lista. No entanto, se você selecionar Mais (...) no canto inferior direito da seção Chat, poderá exibir o aplicativo de guia com um link para a funcionalidade do aplicativo de bot desse aplicativo.

Aplicativos que não estão na Teams Store

Se você estiver carregando seu aplicativo personalizado ou publicando no catálogo de aplicativos de uma organização, o comportamento das guias será o mesmo dos aplicativos do Teams Store aprovados pela Microsoft para dispositivos móveis.

Próxima etapa

Confira também