Guias em dispositivos móveis

Ao criar um aplicativo do Microsoft Teams que inclua uma guia, você deve testar como sua guia funciona nos clientes Do Microsoft Teams 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 distribuídos pela Microsoft Teams Store têm um processo de aprovação separado para clientes móveis. O comportamento padrão desses aplicativos é o seguinte:

Funcionalidade 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. Guias 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 para capacidade de resposta móvel. Para qualquer consulta, entre em contato com teamsubm@microsoft.com.
  • Para todos os aplicativos que não são distribuídos por meio do AppSource, as guias abrem em uma webview no aplicativo dentro dos clientes do Teams por padrão e não há nenhum processo de aprovação separado necessário.
  • O comportamento padrão dos aplicativos só é aplicável se distribuído 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 a simpatia móvel, entre teamsubm@microsoft.com em contato 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 a 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 para o usuário. Você também deve usar indicadores de progresso para fornecer comentários aos seus usuários para quaisquer processos de execução longa.

Teste em clientes móveis

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

Distribuição

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 da guia dependem da aprovação do aplicativo.

Aplicativos na Teams Store aprovados para dispositivos móveis

A tabela a seguir descreve a disponibilidade e o comportamento da guia quando o aplicativo está listado na 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 aplicativo pessoal é aberta no cliente móvel do Teams usando sua respectiva contentUrl configuração.

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

A tabela a seguir descreve a disponibilidade e o comportamento da guia quando o aplicativo está listado na 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 configuração do websiteUrl 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 de bot serão mostradas na seção chat se um aplicativo móvel tiver os recursos do bot e da guia.
  • Ao selecionar Chat do aplicativo bot e selecionar Mais (...), você não poderá ver a funcionalidade da 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 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 da guia será o mesmo que os aplicativos da Teams Store aprovados pela Microsoft para dispositivos móveis.

Próxima etapa

Confira também