Suporte de capacidade do TeamsJS no Microsoft 365

A partir da versão 2.0.0, a biblioteca de cliente JavaScript (TeamsJS) do Microsoft Teams permite que determinados tipos de aplicações do Teams sejam executadas no ecossistema do Microsoft 365. As aplicações do Microsoft 365 que podem alojar aplicações do Teams (aplicação Microsoft 365 e Outlook) suportam apenas um subconjunto dos tipos de aplicações e capacidades que pode criar para a plataforma Teams. Este suporte expande-se ao longo do tempo.

Este artigo detalha o nível de suporte das capacidades do TeamsJS versão 2.x em várias aplicações anfitriãs. Para obter mais informações sobre o que mudou entre as versões 1.x e 2.x do TeamsJS, consulte Novidades no TeamsJS versão 2.x.x.

A seguinte tabela capacidade do TeamsJS lista as capacidades do TeamsJS (espaços de nomes públicos) e o respetivo suporte em aplicações anfitriãs do Microsoft 365. Algumas capacidades são marcadas com distintivos Preteridos ou pré-visualizados , que têm os seguintes significados:

Distintivo	Significado
	Esta capacidade está em pré-visualização e está sujeita a alterações com base nos comentários. Não utilize esta capacidade na produção.
	Esta capacidade foi preterida a favor de funcionalidades mais recentes, embora seja suportada para fins de retrocompatibilidade. Para novas aplicações, utilize a capacidade recomendada nas notas de utilização da capacidade preterida.

Os anfitriões do Microsoft 365 são justificados pelos ícones de produto na tabela seguinte:

Teams	Aplicativo Microsoft 365	Outlook

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

Com as tabelas seguintes, selecione qualquer Capacidade do TeamsJS para obter mais detalhes, incluindo documentos de referência, exemplos, notas de utilização e limitações.

Observação

As informações nas tabelas seguintes derivam dos testes realizados com o TeamsJS v2.24 e das versões mais recentes do anfitrião disponíveis durante os testes. O suporte pode variar com base nas modificações subsequentes do anfitrião. Estas tabelas são fornecidas para o ajudar a compreender o suporte de capacidade entre anfitriões. No entanto, certifique-se sempre de que utiliza as chamadas relevantes isSupported() no seu código para verificar o suporte.

Capacidades entre anfitriões

A tabela seguinte lista o suporte de aplicações anfitriãs para capacidades teamsJS que podem ser executadas fora do Teams.

Capacidade do TeamsJS	Web				Desktop					Celular
					Windows					Android			iOS
aplicação	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓
autenticação	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
calendar				✓				✓	✓			✓			✓
chamada	✓	✓		✓	✓	✓			✓	✓			✓
	✓	✓		✓	✓	✓			✓	✓			✓
Destaque da área de transferência		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓
caixa de diálogo	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
distintivo geoLocalização		✓	✓			✓	✓	✓
correio				✓				✓	✓						✓
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
distintivo de perfil		✓		✓		✓		✓	✓
distintivo de	✓	✓		✓	✓	✓		✓	✓
secondaryBrowser											✓	✓		✓	✓

Capacidades apenas do Teams

A tabela seguinte lista o suporte para as capacidades do TeamsJS que são executadas apenas no ambiente do Teams.

Capacidade do TeamsJS	Web				Desktop					Celular
					Windows					Android			iOS
destaque appInitialization	✓				✓					✓			✓
	✓	✓			✓	✓				✓			✓
menus					✓					✓			✓
Pessoas	✓	✓			✓	✓				✓			✓
definições	✓				✓					✓			✓
partilha	✓	✓			✓	✓				✓			✓
	✓	✓			✓	✓
	✓				✓					✓			✓
teamsCore	✓	✓			✓	✓				✓			✓
										✓			✓
Distintivo webStorage					✓					✓			✓

Capacidades de pré-visualização à espera do suporte do anfitrião

Algumas funcionalidades na origem estão em pré-visualização antecipada e ainda aguardam suporte inicial numa ou mais aplicações anfitriãs que incluem barCode, multimédia e reunião.

Mais adiante neste artigo, pode encontrar mais informações sobre cada capacidade da biblioteca de cliente JavaScript do Teams.

app

Referência | Problemas conhecidos

Espaço de nomes para interagir com a inicialização e o ciclo de vida da aplicação.

O app espaço de nomes é suportado globalmente em todos os anfitriões de aplicações e, por conseguinte, não tem uma função isSupported .

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

appInitialization

Referência | Problemas conhecidos

Depreciado. Espaço de nomes para inicializar uma aplicação. Para novas aplicações, utilize app.initialize() a partir da capacidade da aplicação .

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

appInstallDialog

Referência | Problemas conhecidos

Espaço de nomes utilizado para abrir uma caixa de diálogo para instalar uma aplicação.

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

authentication

Referência | Problemas conhecidos

Espaço de nomes para interagir com a parte relacionada com a autenticação da biblioteca. Este módulo é utilizado para iniciar ou concluir fluxos de autenticação.

O authentication espaço de nomes é suportado globalmente em todos os anfitriões de aplicações e, por conseguinte, não tem uma função isSupported .

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

barCode

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes para interagir com a parte relacionada com a análise de códigos de barras da biblioteca.

	Web				Desktop					Celular
					Windows					Android			iOS
barCode

calendar

Referência | Problemas conhecidos

Espaço de nomes que fornece funcionalidades relacionadas com o calendário.

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

call

Referência | Problemas conhecidos

Espaço de nomes que fornece funcionalidades para iniciar uma chamada com outras pessoas.

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

chat

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes que fornece funcionalidades para iniciar uma conversa com outras pessoas.

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

clipboard

Reference

Previsualizar. Esta capacidade permite que os utilizadores copiem e colem na área de transferência do sistema.

	Web				Desktop					Celular
					Windows					Android			iOS
Destaque da área de transferência		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓

dialog

Referência | Problemas conhecidos

Previsualizar. Este grupo de capacidades permite que as aplicações mostrem caixas de diálogo modais (referidas como módulos de tarefas no TeamsJS v1.x). Existem dois tipos principais de caixas de diálogo: caixas de diálogo baseadas em URL e caixas de diálogo Cartão Ajustável. Ambos os tipos de caixas de diálogo são apresentados na parte superior da sua aplicação, o que impede a interação com a sua aplicação enquanto são apresentadas.

• As caixas de diálogo baseadas em URL permitem-lhe especificar um URL a partir do qual os conteúdos são apresentados dentro da caixa de diálogo. Para caixas de diálogo de URL, utilize as funções e interfaces no espaço de nomes do URL.
• As caixas de diálogo baseadas em Cartões Adaptáveis permitem-lhe fornecer JSON que descreve um Cartão Ajustável que é apresentado dentro da caixa de diálogo. Para caixas de diálogo Cartão Ajustável, utilize as funções e interfaces no espaço de nomes adaptávelCard.

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

dialog.adaptiveCard

Referência | Problemas conhecidos

Previsualizar. Subcapability for interacting with Adaptive Card dialogs(Subcapability for interacting with Adaptive Card dialogs).

dialog.adaptiveCard.bot

Referência | Problemas conhecidos

Previsualizar. Subcapability for interaction with Adaptive Card dialogs that need to communicate with the Bot Framework.

dialog.update

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes para atualizar caixas de diálogo.

dialog.url

Referência | Problemas conhecidos

Previsualizar. Subcapability para interagir com caixas de diálogo baseadas em HTML.

dialog.url.bot

Referência | Problemas conhecidos

Previsualizar. Subcapability for interacting with HTML-based dialogs that need to communicate with the Bot Framework.

geoLocation

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes que fornece funcionalidades relacionadas com a localização. Esta é a versão mais recente do módulo de localização.

As capacidades que exigem que o utilizador conceda permissões de dispositivos (como geoLocalização) são parcialmente suportadas para aplicações em execução fora do Teams. Os utilizadores podem ajustar as permissões da aplicação a partir do cabeçalho da aplicação ao executar na aplicação Outlook e Microsoft 365 ou a partir das definições da aplicação em dispositivos móveis. Recomenda-se modificar o código para verificar a capacidade de suporte do Outlook e do Microsoft 365:

• Chame isSupported uma capacidade antes de a utilizar.
• Detetar e processar erros ao chamar APIs teamsJS e HTML5

Quando uma API não suporta ou gera um erro, adicione lógica para falhar ou fornecer uma solução. Por exemplo:

• Direcionar o utilizador para o site da sua aplicação
• Direcionar o utilizador para utilizar a aplicação no Teams para concluir o fluxo
• Notificar o utilizador de que a funcionalidade ainda não está disponível

Dica

Certifique-se de que o manifesto da aplicação especifica apenas as permissões do dispositivo que está a utilizar.

	Web				Desktop					Celular
					Windows					Android			iOS
distintivo geoLocalização		✓	✓			✓	✓	✓
distintivo geoLocation.map		✓				✓

geoLocation.map

Referência | Problemas conhecidos

Previsualizar. Subcapability que fornece funcionalidades relacionadas com o mapa.

location

Referência | Problemas conhecidos

Depreciado. Espaço de nomes que fornece funcionalidades relacionadas com a localização (obter e mostrar localização). Utilize geoLocalização para novas aplicações.

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

mail

Referência | Problemas conhecidos

Espaço de nomes que fornece funcionalidades relacionadas com o e-mail.

	Web				Desktop					Celular
					Windows					Android			iOS
Email				✓				✓	✓						✓

media

Referência | Problemas conhecidos

Espaço de nomes que fornece funcionalidades relacionadas com ficheiros de imagem.

	Web				Desktop					Celular
					Windows					Android			iOS
mídia

meeting

Referência | Problemas conhecidos

Espaço de nomes que fornece a funcionalidade da aplicação na reunião.

	Web				Desktop					Celular
					Windows					Android			iOS
reunião

Observação

Os seguintes métodos não são suportados no cliente móvel do Teams:

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

menus

Referência | Problemas conhecidos

Espaço de nomes para interagir com a parte relacionada com o menu da biblioteca. Este módulo é utilizado para mostrar a Configuração da Vista, o Menu de Ação e o Menu da Barra de Navegação.

	Web				Desktop					Celular
					Windows					Android			iOS
menus					✓					✓			✓

pages

Referência | Problemas conhecidos

Parte relacionada com a navegação da biblioteca do TeamsJS.

Antes da versão 2.0 do TeamsJS, todos os cenários de ligação profunda eram processados com shareDeepLink (para gerar uma ligação para uma parte específica da sua aplicação) e executeDeepLink (para navegar para uma ligação avançada a partir oudentro da sua aplicação). O TeamsJS v.2.0 apresenta uma nova API, navigateToApp, para navegar para páginas (e subpáginas) numa aplicação de forma consistente entre anfitriões de aplicações (aplicação Microsoft 365 e Outlook, além do Teams). Para novas aplicações, siga as orientações atualizadas associadas consoante o seu cenário de navegação:

• Ligações avançadas para a sua aplicação. 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 selecionada, é pedido ao utilizador que instale a aplicação se ainda não estiver instalada para o anfitrião da aplicação.

• Navegação na sua aplicação. Utilize o novo pages.currentApp espaço de nomes para navegar na sua aplicação na aplicação de alojamento. Especificamente, a função navigateTo(NavigateWithinAppParams) para permitir a navegação para um separador específico na aplicação atual e a função navigateToDefaultPage() para navegar para o primeiro separador definido no manifesto da aplicação. Para obter mais informações, veja Navegar numa aplicação de separador.

  Estas APIs fornecem o equivalente a navegar para uma ligação avançada (uma vez que a executeDeepLink preterida já foi utilizada) sem exigir que a sua aplicação construa um URL ou faça a gestão de diferentes formatos de ligação avançada para diferentes anfitriões de aplicações.

• Ligações avançadas da sua aplicação. Para obter ligações avançadas da sua aplicação para várias áreas do anfitrião atual, utilize as APIs digitadas fornecidas pela biblioteca do TeamsJS. Por exemplo, utilize a calendar capacidade para abrir uma caixa de diálogo de agendamento ou um item de calendário a partir da sua aplicação.

  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 são suportados 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 da aplicação do SDK.

pages.backStack

Referência | Problemas conhecidos

Fornece APIs para processar o histórico de navegação do utilizador.

pages.config

Referência | Problemas conhecidos

Fornece APIs para interagir com a parte específica da configuração do SDK. Este objeto só é utilizável na moldura de configuração.

pages.currentApp

Referência | Problemas conhecidos

Fornece funções para navegar sem ter de especificar o ID da aplicação.

pages.tabs

Referência | Problemas conhecidos

Fornece APIs para consultar e navegar entre separadores contextuais de uma aplicação. Ao contrário dos separadores pessoais, os separadores contextuais são páginas associadas a um contexto específico, como o canal ou o chat.

people

Referência | Problemas conhecidos

Espaço de nomes que fornece funcionalidades para a API do Selecionador de Pessoas.

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

profile

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes que fornece funcionalidades relacionadas com o perfil.

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

Observação

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

search

Referência | Problemas conhecidos

Previsualizar. Permite que a sua aplicação interaja com a caixa de pesquisa da aplicação do Microsoft 365 do anfitrião. Ao integrar a sua aplicação na caixa de pesquisa do anfitrião, os utilizadores podem procurar na sua aplicação através da mesma caixa de pesquisa que utilizam noutro local no Teams, Outlook ou na aplicação Microsoft 365.

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

secondaryBrowser

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes que suporta experiências de browser na aplicação da aplicação anfitriã. Por exemplo, abrir um URL na aplicação anfitriã dentro de um browser.

	Web				Desktop					Celular
					Windows					Android			iOS
secondaryBrowser											✓	✓		✓	✓

settings

Referência | Problemas conhecidos

Depreciado. Fornece funcionalidades relacionadas com definições. Utilize APIs equivalentes das páginas para novas aplicações.

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

sharing

Referência | Problemas conhecidos

Espaço de nomes para abrir uma caixa de diálogo de partilha para conteúdo 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 é suportado no cliente móvel do Teams.

stageView

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes para interagir com a parte específica do Stageview da biblioteca.

	Web				Desktop					Celular
					Windows					Android			iOS
	✓	✓			✓	✓

tasks

Referência | Problemas conhecidos

A versão anterior da capacidade para fornecer caixas de diálogo modais (referida como módulos de tarefas no TeamsJS v1.x) suporta versões anteriores ao TeamsJS v2.8.0. Para novas aplicações, utilize a capacidade de caixa de diálogo .

	Web				Desktop					Celular
					Windows					Android			iOS
	✓				✓					✓			✓

Observação

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

teamsCore

Referência | Problemas conhecidos

Espaço de nomes que contém o conjunto de APIs que suportam funcionalidades específicas do Teams.

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

video

Referência | Problemas conhecidos

Previsualizar. Espaço de nomes 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 são suportados no cliente móvel do Teams:

• video.notifySelectedVideoEffectChanged
• video.registerForVideoEffect

webStorage

Referência | Problemas conhecidos

Previsualizar. Contém funcionalidades para permitir que as aplicações Web armazenem dados na cache do Webview.

	Web				Desktop					Celular
					Windows					Android			iOS
Distintivo webStorage					✓					✓			✓

Observação

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

Confira também

• Estender aplicativos do Teams pelo Microsoft 365
• Expandir um separador pessoal do Teams na aplicação Microsoft 365
• Referência da API do TeamsJS