Suporte à funcionalidade do TeamsJS no Microsoft 365

A partir da versão 2.0.0, a biblioteca de clientes JavaScript do Microsoft Teams (TeamsJS) permite que determinados tipos de aplicativos do Teams sejam executados em todo o ecossistema do Microsoft 365. Atualmente, os aplicativos do Microsoft 365 que podem hospedar aplicativos do Teams (aplicativo Microsoft 365 e Outlook) dão suporte apenas a um subconjunto dos tipos e recursos de aplicativo que você pode criar para a plataforma do Teams. Esse suporte se expande ao longo do tempo.

Este artigo detalha o nível de suporte dos recursos do TeamsJS versão 2.x em vários aplicativos host. Para obter mais informações sobre o que foi alterado entre as versões do TeamsJS 1.x e 2.x, confira Novidades na versão 2.x.x do TeamsJS.

A tabela de recursos do TeamsJS a seguir lista os recursos do TeamsJS (namespaces públicos) e seu suporte em aplicativos host do Microsoft 365. Alguns recursos são marcados com selos preteridos ou visualizados , que têm os seguintes significados:

Distintivo	Significado
	Esse recurso está em versão prévia e sujeito a alterações com base nos comentários. Não use essa funcionalidade na produção.
	Essa funcionalidade é preterida em favor da funcionalidade mais recente, embora tenha suporte para fins de compatibilidade com versões anteriores. Para novos aplicativos, use a funcionalidade recomendada nas notas de uso da funcionalidade preterida.

Os hosts do Microsoft 365 são assinados pelos ícones do produto na tabela a seguir:

Teams	Aplicativo Microsoft 365	Outlook

Para obter mais informações sobre o novo Teams e o Outlook, consulte o blog do Outlook e a adoção do Teams.

Usando a tabela a seguir, selecione qualquer Recurso do TeamsJS para obter mais detalhes, incluindo documentos de referência, exemplos, notas de uso e limitações.

Recursos de host cruzado

A tabela a seguir lista o suporte ao aplicativo host para recursos do TeamsJS que podem ser executados fora do Teams.

Funcionalidade do TeamsJS	Web				Desktop					Celular
					Windows					Android			iOS
App	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓
autenticação	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
calendar				✓				✓	✓			✓			✓
chamada	✓	✓		✓	✓	✓			✓	✓			✓
	✓	✓		✓	✓	✓			✓	✓			✓
Selo de área		✓	✓	✓		✓	✓	✓	✓					✓	✓
caixa de diálogo	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
Selo de geolocalização			✓				✓	✓
Correio				✓				✓	✓						✓
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Selo de perfil				✓				✓	✓
Selo de pesquisa	✓	✓			✓	✓		✓
Selo secondaryBrowser											✓	✓		✓	✓

Recursos somente do Teams

A tabela a seguir lista o suporte para recursos do TeamsJS executados apenas no ambiente do Teams.

Funcionalidade do TeamsJS	Web				Desktop					Celular
					Windows					Android			iOS
Selo appInitialization	✓				✓					✓			✓
Selo de	✓				✓					✓			✓
Menus										✓			✓
Pessoas	✓	✓			✓	✓				✓			✓
configurações	✓				✓					✓			✓
Compartilhar	✓	✓			✓	✓				✓			✓
Selo stageView	✓	✓			✓	✓
crachá de tarefas	✓				✓					✓			✓
teamsCore	✓	✓			✓	✓				✓			✓
										✓			✓
Selo webStorage					✓					✓			✓

Recursos de visualização aguardando suporte ao host

Alguns recursos na origem estão em versão prévia antecipada e ainda aguardam suporte inicial em um ou mais aplicativos host que incluem barCode, mídia e reunião.

Posteriormente neste artigo, você pode encontrar mais informações sobre cada recurso da biblioteca de clientes JavaScript do Teams.

app

Referência | Problemas conhecidos

Namespace para interagir com a inicialização do aplicativo e o ciclo de vida.

O app namespace tem suporte global em todos os hosts de aplicativo e, portanto, não tem uma isSupported função.

	Web				Desktop					Celular
					Windows					Android			iOS
aplicativo	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

appInitialization

Referência | Problemas conhecidos

Depreciado. Namespace para inicializar um aplicativo. Para novos aplicativos, use app.initialize() do recurso do aplicativo .

	Web				Desktop					Celular
					Windows					Android			iOS
Selo appInitialization	✓				✓					✓			✓

appInstallDialog

Referência | Problemas conhecidos

Namespace usado para abrir uma caixa de diálogo para instalar um aplicativo.

	Web				Desktop					Celular
					Windows					Android			iOS
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓

authentication

Referência | Problemas conhecidos

Namespace para interagir com a parte relacionada à autenticação da biblioteca. Este módulo é usado para iniciar ou concluir fluxos de autenticação.

O authentication namespace tem suporte global em todos os hosts de aplicativo e, portanto, não tem uma isSupported função.

	Web				Desktop					Celular
					Windows					Android			iOS
autenticação	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

barCode

Referência | Problemas conhecidos

Visualizar. Namespace para interagir com a parte relacionada à verificação de código de barras da biblioteca.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo barCode

calendar

Referência | Problemas conhecidos

Namespace fornecendo funcionalidade relacionada ao calendário.

	Web				Desktop					Celular
					Windows					Android			iOS
calendar				✓				✓	✓			✓			✓

call

Referência | Problemas conhecidos

Namespace fornecendo funcionalidade para iniciar uma chamada com outras pessoas.

	Web				Desktop					Celular
					Windows					Android			iOS
call	✓	✓		✓	✓	✓			✓	✓			✓

chat

Referência | Problemas conhecidos

Visualizar. Namespace fornecendo funcionalidade para iniciar um chat com outras pessoas.

	Web				Desktop					Celular
					Windows					Android			iOS
	✓	✓		✓	✓	✓			✓	✓			✓

clipboard

Reference

Visualizar. Esse recurso permite que os usuários copiem e colem na área de transferência do sistema.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo de área		✓	✓	✓		✓	✓	✓	✓					✓	✓

dialog

Referência | Problemas conhecidos

Visualizar. Esse grupo de recursos permite que os aplicativos mostrem caixas de diálogo modais (conhecidos como módulos de tarefa no TeamsJS v1.x). Há dois tipos principais de caixas de diálogo: caixas de diálogo baseadas em URL e caixas de diálogo Cartão Adaptável. Ambos os tipos de caixas de diálogo são mostrados na parte superior do aplicativo, impedindo a interação com seu aplicativo enquanto são exibidos.

• As caixas de diálogo baseadas em URL permitem especificar uma URL da qual o conteúdo é mostrado dentro da caixa de diálogo. Para caixas de diálogo URL, use as funções e interfaces no namespace da url.
• As caixas de diálogo baseadas em cartão adaptável permitem que você forneça JSON descrevendo um Cartão Adaptável que é mostrado dentro da caixa de diálogo. Para caixas de diálogo Cartão Adaptável, use as funções e interfaces no namespace adaptiveCard.

	Web				Desktop					Celular
					Windows					Android			iOS
caixa de diálogo	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
discagem.adaptiveCard		✓	✓			✓	✓	✓		✓			✓
caixa de diálogo.adaptiveCard.bot		✓				✓		✓		✓			✓
dialog.update	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
selo dialog.url	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
selo dialog.url.bot	✓	✓		✓	✓	✓		✓	✓	✓			✓

dialog.adaptiveCard

Referência | Problemas conhecidos

Visualizar. Subcapbilidade para interagir com caixas de diálogo Cartão Adaptável.

dialog.adaptiveCard.bot

Referência | Problemas conhecidos

Visualizar. Subcapbilidade para interação com caixas de diálogo Cartão Adaptável que precisam se comunicar com o Bot Framework.

dialog.update

Referência | Problemas conhecidos

Visualizar. Namespace para atualizar caixas de diálogo.

dialog.url

Referência | Problemas conhecidos

Visualizar. Subcapbilidade para interagir com caixas de diálogo baseadas em HTML.

dialog.url.bot

Referência | Problemas conhecidos

Visualizar. Subcapbilidade para interagir com caixas de diálogo baseadas em HTML que precisam se comunicar com o Bot Framework.

geoLocation

Referência | Problemas conhecidos

Visualizar. Namespace fornecendo funcionalidade relacionada à localização. Esta é a versão mais recente do módulo de localização.

Recursos que exigem que o usuário conceda permissões de dispositivo (como geoloCalização) têm suporte parcial para aplicativos executados fora do Teams. Os usuários podem ajustar permissões de aplicativo do cabeçalho do aplicativo ao executar no aplicativo Outlook e Microsoft 365 ou em configurações de aplicativo no celular. É recomendável modificar o código para marcar a capacidade de suporte do Outlook e do Microsoft 365:

• Chame isSupported uma funcionalidade antes de usá-la.
• Capturar e manipular erros ao chamar APIs do TeamsJS e HTML5

Quando uma API não dá suporte ou gera um erro, adicione lógica para falhar ou forneça uma solução alternativa. Por exemplo:

• Direcionar o usuário para o site do seu aplicativo
• Direcione o usuário a usar o aplicativo no Teams para concluir o fluxo
• Notifique o usuário de que a funcionalidade ainda não está disponível

Dica

Verifique se o manifesto do aplicativo especifica apenas as permissões de dispositivo que ele está usando.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo de geolocalização			✓				✓	✓
geoLocation.map

geoLocation.map

Referência | Problemas conhecidos

Visualizar. Subcapabilidade fornecendo funcionalidade relacionada ao mapa.

location

Referência | Problemas conhecidos

Depreciado. Namespace fornecendo funcionalidade relacionada à localização (obter e mostrar local). Use geoLocation para novos aplicativos.

	Web				Desktop					Celular
					Windows					Android			iOS
	✓				✓					✓			✓

mail

Referência | Problemas conhecidos

Namespace fornecendo funcionalidade relacionada a email.

	Web				Desktop					Celular
					Windows					Android			iOS
Email				✓				✓	✓						✓

media

Referência | Problemas conhecidos

Namespace fornecendo funcionalidade relacionada ao arquivo de imagem.

	Web				Desktop					Celular
					Windows					Android			iOS
mídia

meeting

Referência | Problemas conhecidos

Namespace fornecendo funcionalidade de aplicativo na reunião.

	Web				Desktop					Celular
					Windows					Android			iOS
Reunião

Observação

Os seguintes métodos não têm suporte no cliente móvel do Teams:

• meeting.requestStartLiveStreaming
• meeting.requestStopLiveStreaming
• meeting.getLiveStreamState
• meeting.registerLiveStreamChangedHandler

menus

Referência | Problemas conhecidos

Namespace para interagir com a parte relacionada ao menu da biblioteca. Este módulo é usado para mostrar o Menu Exibir Configuração, Menu de Ação e Barra de Navegação.

	Web				Desktop					Celular
					Windows					Android			iOS
Menus										✓			✓

pages

Referência | Problemas conhecidos

Parte relacionada à navegação da biblioteca do TeamsJS.

Antes do TeamsJS versão 2.0, todos os cenários de vinculação profunda eram tratados usando shareDeepLink (para gerar um link para uma parte específica do seu aplicativo) e executeDeepLink (para navegar até um link profundo de ou dentro de seu aplicativo). O TeamsJS v.2.0 apresenta uma nova API, navigateToApp, para navegar até páginas (e subpages) dentro de um aplicativo de forma consistente entre hosts de aplicativos (aplicativo Microsoft 365 e Outlook, além do Teams). Para novos aplicativos, siga as diretrizes atualizadas vinculadas dependendo do cenário de navegação:

• Links profundos em seu aplicativo. Use pages.shareDeepLink (conhecido como shareDeepLink antes do TeamsJS v.2.0) para gerar e exibir um link copiável para o usuário compartilhar. Quando selecionado, o usuário será solicitado a instalar o aplicativo se ele ainda não estiver instalado para o host do aplicativo.

• Navegação em seu aplicativo. Use o novo pages.currentApp namespace para navegar dentro do aplicativo no aplicativo de hospedagem. Especificamente, a função navigateTo(NavigateWithinAppParams) para permitir a navegação para uma guia específica dentro do aplicativo atual e a função navigateToDefaultPage() para navegar até a primeira guia definida no manifesto do aplicativo. Para obter mais informações, confira navegar em um aplicativo de guias.

  Essas APIs fornecem o equivalente a navegar até um link profundo (como o executeDeepLink agora preterido já foi usado) sem exigir que seu aplicativo construa uma URL ou gerencie diferentes formatos de link profundo para diferentes hosts de aplicativo.

• Links profundos fora do seu aplicativo. Para links profundos do aplicativo para várias áreas do host atual, use as APIs tipada fornecidas pela biblioteca do TeamsJS. Por exemplo, use o calendar recurso para abrir uma caixa de diálogo de agendamento ou um item de calendário do seu aplicativo.

  Para links profundos do seu aplicativo para outros aplicativos em execução no mesmo host, use pages.navigateToApp.

  Para qualquer outro cenário de vinculação profunda externa, você pode usar o app.openLink, que fornece funcionalidade semelhante à agora preterida (começando no TeamsJS v.2.0) API executeDeepLink.

	Web				Desktop					Celular
					Windows					Android			iOS
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
pages.appButton	✓	✓	✓		✓	✓	✓
pages.backStack	✓	✓			✓	✓				✓	✓	✓	✓		✓
pages.currentApp		✓	✓	✓		✓	✓	✓	✓		✓	✓		✓	✓
pages.config	✓	✓			✓	✓		✓		✓		✓	✓		✓
pages.tabs	✓	✓			✓	✓

Observação

Os seguintes métodos não têm suporte no cliente móvel do Teams:

• pages.getConfig
• pages.setCurrentFrame
• pages.initializeWithFrameContext
• pages.tabs.navigateToTab
• pages.tabs.getMruTabInstances
• pages.tabs.getTabInstances

pages.appButton

Referência | Problemas conhecidos

Fornece APIs para interagir com a parte do botão do aplicativo do SDK.

pages.backStack

Referência | Problemas conhecidos

Fornece APIs para lidar com o histórico de navegação do usuário.

pages.config

Referência | Problemas conhecidos

Fornece APIs para interagir com a parte específica da configuração do SDK. Esse objeto é utilizável somente no quadro de configuração.

pages.currentApp

Referência | Problemas conhecidos

Fornece funções para navegar sem precisar especificar sua ID do aplicativo.

pages.tabs

Referência | Problemas conhecidos

Fornece APIs para consultar e navegar entre guias contextuais de um aplicativo. Ao contrário das guias pessoais, as guias contextuais são páginas associadas a um contexto específico, como canal ou chat.

people

Referência | Problemas conhecidos

Namespace fornecendo funcionalidade para Pessoas API do Seletor.

	Web				Desktop					Celular
					Windows					Android			iOS
people	✓	✓			✓	✓				✓			✓

profile

Referência | Problemas conhecidos

Visualizar. Namespace que fornece a funcionalidade relacionada ao perfil.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo de perfil				✓				✓	✓

Observação

O profile.showProfile método não tem suporte no cliente móvel do Teams.

search

Referência | Problemas conhecidos

Visualizar. Permite que seu aplicativo interaja com a caixa de pesquisa do aplicativo Host Microsoft 365. Ao integrar seu aplicativo à caixa de pesquisa do host, os usuários podem pesquisar seu aplicativo usando a mesma caixa de pesquisa que usam em outros lugares no Teams, Outlook ou aplicativo Microsoft 365.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo de pesquisa	✓	✓			✓	✓		✓

secondaryBrowser

Referência | Problemas conhecidos

Visualizar. Namespace com suporte a experiências do navegador no aplicativo do aplicativo host. Por exemplo, abrir uma URL no aplicativo host dentro de um navegador.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo secondaryBrowser											✓	✓		✓	✓

settings

Referência | Problemas conhecidos

Depreciado. Fornece funcionalidade relacionada a configurações. Use APIs equivalentes das páginas para novos aplicativos.

	Web				Desktop					Celular
					Windows					Android			iOS
configurações	✓				✓					✓			✓

sharing

Referência | Problemas conhecidos

Namespace para abrir uma caixa de diálogo de compartilhamento para conteúdo da Web. Para obter mais informações, consulte Compartilhar com o Teams de um aplicativo pessoal ou guia.

	Web				Desktop					Celular
					Windows					Android			iOS
compartilhamento	✓	✓			✓	✓				✓			✓

Observação

O sharing.shareWebContent método não tem suporte no cliente móvel do Teams.

stageView

Referência | Problemas conhecidos

Visualizar. Namespace para interagir com a parte específica do Stageview da biblioteca.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo stageView	✓	✓			✓	✓

tasks

Referência | Problemas conhecidos

A versão anterior do recurso para fornecer caixas de diálogo modais (conhecidas como módulos de tarefa no TeamsJS v1.x) dá suporte a versões anteriores ao TeamsJS v2.8.0. Para novos aplicativos, use o recurso de caixa de diálogo .

	Web				Desktop					Celular
					Windows					Android			iOS
crachá de tarefas	✓				✓					✓			✓

Observação

O task.getDefaultSizeIfNotProvided método não tem suporte no cliente móvel do Teams.

teamsCore

Referência | Problemas conhecidos

Namespace que contém o conjunto de APIs que dão suporte a funcionalidades específicas do Teams.

	Web				Desktop					Celular
					Windows					Android			iOS
teamsCore	✓	✓			✓	✓				✓			✓

video

Referência | Problemas conhecidos

Visualizar. Namespace que representa a funcionalidade para efeitos de vídeo na reunião.

	Web				Desktop					Celular
					Windows					Android			iOS
										✓			✓

Observação

Os seguintes métodos não têm suporte no cliente móvel do Teams:

• video.notifySelectedVideoEffectChanged
• video.registerForVideoEffect

webStorage

Referência | Problemas conhecidos

Visualizar. Contém funcionalidade para permitir que os aplicativos Web armazenem dados no cache da Webview.

	Web				Desktop					Celular
					Windows					Android			iOS
Selo webStorage					✓					✓			✓

Observação

O webStorage.isWebStorageClearedOnUserLogOut método não tem suporte no cliente móvel do Teams.

Confira também

• Estender aplicativos do Teams pelo Microsoft 365
• Estender uma guia pessoal do Teams no aplicativo Microsoft 365
• Visão geral da biblioteca de clientes JavaScript do Teams
• Referência de API do TeamsJS