Compatibilidad con la funcionalidad TeamsJS en Microsoft 365

A partir de la versión 2.0.0, la biblioteca cliente JavaScript de Microsoft Teams (TeamsJS) permite que determinados tipos de aplicaciones de Teams se ejecuten en el ecosistema de Microsoft 365. Las aplicaciones de Microsoft 365 que pueden hospedar aplicaciones de Teams (aplicaciones de Microsoft 365 y Outlook) solo admiten un subconjunto de los tipos de aplicación y las funcionalidades que puede crear para la plataforma teams. Esta compatibilidad se expande con el tiempo.

En este artículo se detalla el nivel de compatibilidad de las funcionalidades de TeamsJS versión 2.x en varias aplicaciones host. Para obtener más información sobre lo que ha cambiado entre las versiones 1.x y 2.x de TeamsJS, vea Novedades de TeamsJS versión 2.x.x.

En la siguiente tabla Funcionalidad de TeamsJS se enumeran las funcionalidades de TeamsJS (espacios de nombres públicos) y su compatibilidad con las aplicaciones host de Microsoft 365. Algunas funcionalidades están marcadas con distintivos en desuso o en versión preliminar , que tienen los significados siguientes:

Insignia	Significado
	Esta funcionalidad está en versión preliminar y está sujeta a cambios en función de los comentarios. No use esta funcionalidad en producción.
	Esta funcionalidad está en desuso en favor de la funcionalidad más reciente, aunque se admite con fines de compatibilidad con versiones anteriores. En el caso de las nuevas aplicaciones, use la funcionalidad recomendada en las notas de uso de la funcionalidad en desuso.

Los hosts de Microsoft 365 están marcados por los iconos de producto de la tabla siguiente:

Teams	Aplicación de Microsoft 365	Outlook

Para obtener más información sobre los nuevos Teams y Outlook, consulte el blog de Outlook y adopción de Teams.

Con las tablas siguientes, seleccione cualquier funcionalidad de TeamsJS para obtener más detalles, como documentos de referencia, ejemplos, notas de uso y limitaciones.

Nota:

La información de las tablas siguientes se deriva de las pruebas realizadas con TeamsJS v2.24 y las versiones de host más recientes disponibles durante las pruebas. La compatibilidad puede variar en función de las modificaciones posteriores del host. Estas tablas se proporcionan para ayudarle a comprender la compatibilidad de funcionalidad entre hosts; sin embargo, asegúrese siempre de usar las llamadas pertinentes isSupported() en el código para comprobar la compatibilidad.

Funcionalidades entre hosts

En la tabla siguiente se muestra la compatibilidad de aplicaciones host con las funcionalidades de TeamsJS que se pueden ejecutar fuera de Teams.

Capacidad de TeamsJS	Web				Escritorio					Móvil
					Windows					Android			iOS
aplicación	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓
authentication	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
calendar				✓				✓	✓			✓			✓
call	✓	✓		✓	✓	✓			✓	✓			✓
	✓	✓		✓	✓	✓			✓	✓			✓
Distintivo del portapapeles		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓
distintivo de cuadro de diálogo	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
distintivo geoLocation		✓	✓			✓	✓	✓
correo				✓				✓	✓						✓
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
notificación de perfil		✓		✓		✓		✓	✓
	✓	✓		✓	✓	✓		✓	✓
.											✓	✓		✓	✓

Funcionalidades solo de Teams

En la tabla siguiente se muestra la compatibilidad con las funcionalidades de TeamsJS que solo se ejecutan en el entorno de Teams.

Capacidad de TeamsJS	Web				Escritorio					Móvil
					Windows					Android			iOS
notificación appInitialization	✓				✓					✓			✓
distintivo de ubicación	✓	✓			✓	✓				✓			✓
Menús					✓					✓			✓
people	✓	✓			✓	✓				✓			✓
configuración	✓				✓					✓			✓
compartición	✓	✓			✓	✓				✓			✓
distintivo stageView	✓	✓			✓	✓
	✓				✓					✓			✓
teamsCore	✓	✓			✓	✓				✓			✓
										✓			✓
					✓					✓			✓

Funcionalidades de versión preliminar en espera de compatibilidad con host

Algunas funcionalidades del origen están en versión preliminar temprana y siguen esperando la compatibilidad inicial en una o varias aplicaciones host que incluyen barCode, media y meeting.

Más adelante en este artículo, puede encontrar más información sobre cada funcionalidad de la biblioteca cliente de JavaScript de Teams.

app

Referencia | Problemas conocidos

Namespace interactuar con la inicialización y el ciclo de vida de la aplicación.

El app espacio de nombres se admite globalmente en todos los hosts de aplicación y, por lo tanto, no tiene una isSupported función.

	Web				Escritorio					Móvil
					Windows					Android			iOS
aplicación	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

appInitialization

Referencia | Problemas conocidos

Obsoleto. Namespace para inicializar una aplicación. Para las aplicaciones nuevas, use app.initialize() desde la funcionalidad de la aplicación .

	Web				Escritorio					Móvil
					Windows					Android			iOS
notificación appInitialization	✓				✓					✓			✓

appInstallDialog

Referencia | Problemas conocidos

Namespace se usa para abrir un cuadro de diálogo para instalar una aplicación.

	Web				Escritorio					Móvil
					Windows					Android			iOS
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓

authentication

Referencia | Problemas conocidos

Namespace interactuar con la parte relacionada con la autenticación de la biblioteca. Este módulo se usa para iniciar o completar flujos de autenticación.

El authentication espacio de nombres se admite globalmente en todos los hosts de aplicación y, por lo tanto, no tiene una isSupported función.

	Web				Escritorio					Móvil
					Windows					Android			iOS
autenticación	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

barCode

Referencia | Problemas conocidos

Vista previa. Namespace interactuar con la parte relacionada con el escaneo de códigos de barras de la biblioteca.

	Web				Escritorio					Móvil
					Windows					Android			iOS
distintivo de código de barra

calendar

Referencia | Problemas conocidos

Namespace proporcionar funcionalidad relacionada con el calendario.

	Web				Escritorio					Móvil
					Windows					Android			iOS
calendar				✓				✓	✓			✓			✓

call

Referencia | Problemas conocidos

Namespace proporcionar funcionalidad para iniciar una llamada con otros usuarios.

	Web				Escritorio					Móvil
					Windows					Android			iOS
llamada	✓	✓		✓	✓	✓			✓	✓			✓

chat

Referencia | Problemas conocidos

Vista previa. Namespace proporcionar funcionalidad para iniciar un chat con otros usuarios.

	Web				Escritorio					Móvil
					Windows					Android			iOS
	✓	✓		✓	✓	✓			✓	✓			✓

clipboard

Reference

Vista previa. Esta funcionalidad permite a los usuarios copiar y pegar en el Portapapeles del sistema.

	Web				Escritorio					Móvil
					Windows					Android			iOS
Distintivo del portapapeles		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓

dialog

Referencia | Problemas conocidos

Vista previa. Este grupo de funcionalidades permite a las aplicaciones mostrar diálogos modales (denominados módulos de tareas en TeamsJS v1.x). Hay dos tipos principales de diálogos: diálogos basados en direcciones URL y cuadros de diálogo de tarjeta adaptable. Ambos tipos de diálogos se muestran encima de la aplicación, lo que impide la interacción con la aplicación mientras se muestran.

• Los diálogos basados en direcciones URL permiten especificar una dirección URL desde la que se muestra el contenido dentro del cuadro de diálogo. Para los cuadros de diálogo url, use las funciones e interfaces del espacio de nombres url.
• Los diálogos basados en tarjeta adaptable permiten proporcionar JSON que describe una tarjeta adaptable que se muestra dentro del cuadro de diálogo. Para los diálogos de tarjeta adaptable, use las funciones e interfaces del espacio de nombres adaptiveCard.

	Web				Escritorio					Móvil
					Windows					Android			iOS
	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
distintivo dialog.adaptiveCard		✓	✓			✓	✓	✓		✓			✓
Distintivo dialog.adaptiveCard.bot		✓				✓		✓		✓			✓
distintivo dialog.update	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
distintivo dialog.url	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
distintivo dialog.url.bot	✓	✓		✓	✓	✓		✓	✓	✓			✓

dialog.adaptiveCard

Referencia | Problemas conocidos

Vista previa. Subcapabilidad para interactuar con diálogos de tarjeta adaptable.

dialog.adaptiveCard.bot

Referencia | Problemas conocidos

Vista previa. Capacidad de interacción con cuadros de diálogo de tarjeta adaptable que necesitan comunicarse con Bot Framework.

dialog.update

Referencia | Problemas conocidos

Vista previa. Namespace para actualizar diálogos.

dialog.url

Referencia | Problemas conocidos

Vista previa. Subcapabilidad para interactuar con diálogos basados en HTML.

dialog.url.bot

Referencia | Problemas conocidos

Vista previa. Subcapabilidad para interactuar con diálogos basados en HTML que necesitan comunicarse con Bot Framework.

geoLocation

Referencia | Problemas conocidos

Vista previa. Namespace proporcionar funcionalidad relacionada con la ubicación. Esta es la versión más reciente del módulo de ubicación.

Las funcionalidades que requieren que el usuario conceda permisos de dispositivo (como geoLocation) se admiten parcialmente para las aplicaciones que se ejecutan fuera de Teams. Los usuarios pueden ajustar los permisos de la aplicación desde el encabezado de la aplicación cuando se ejecutan en outlook y la aplicación de Microsoft 365, o desde la configuración de la aplicación en dispositivos móviles. Se recomienda modificar el código para comprobar la compatibilidad con Outlook y Microsoft 365:

• Llame a isSupported una funcionalidad antes de usarla.
• Detectar y controlar errores al llamar a TeamsJS y API HTML5

Cuando una API no admite o genera un error, agregue lógica para producir un error o proporcione una solución alternativa. Por ejemplo:

• Dirigir al usuario al sitio web de la aplicación
• Indique al usuario que use la aplicación en Teams para completar el flujo.
• Notificar al usuario que la funcionalidad aún no está disponible

Sugerencia

Asegúrese de que el manifiesto de la aplicación solo especifica los permisos de dispositivo que usa.

	Web				Escritorio					Móvil
					Windows					Android			iOS
distintivo geoLocation		✓	✓			✓	✓	✓
distintivo geoLocation.map		✓				✓

geoLocation.map

Referencia | Problemas conocidos

Vista previa. Subcapabilidad que proporciona funcionalidad relacionada con el mapa.

location

Referencia | Problemas conocidos

Obsoleto. Namespace proporcionar funcionalidad relacionada con la ubicación (obtener y mostrar ubicación). Use geoLocation para las nuevas aplicaciones.

	Web				Escritorio					Móvil
					Windows					Android			iOS
	✓	✓			✓	✓				✓			✓

mail

Referencia | Problemas conocidos

Namespace proporcionar funcionalidad relacionada con el correo electrónico.

	Web				Escritorio					Móvil
					Windows					Android			iOS
mail				✓				✓	✓						✓

media

Referencia | Problemas conocidos

Namespace proporcionar funcionalidad relacionada con archivos de imagen.

	Web				Escritorio					Móvil
					Windows					Android			iOS
medios

meeting

Referencia | Problemas conocidos

Namespace proporcionar funcionalidad de aplicación en reuniones.

	Web				Escritorio					Móvil
					Windows					Android			iOS
reunión

Nota:

Los métodos siguientes no se admiten en el cliente móvil de Teams:

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

menus

Referencia | Problemas conocidos

Namespace interactuar con la parte relacionada con el menú de la biblioteca. Este módulo se usa para mostrar la configuración de la vista, el menú acción y el menú de la barra de navegación.

	Web				Escritorio					Móvil
					Windows					Android			iOS
Menús					✓					✓			✓

pages

Referencia | Problemas conocidos

Parte relacionada con la navegación de la biblioteca TeamsJS.

Antes de la versión 2.0 de TeamsJS, todos los escenarios de vinculación profunda se administraban mediante shareDeepLink (para generar un vínculo a una parte específica de la aplicación) y executeDeepLink (para navegar a un vínculo profundo desde o dentrode la aplicación). TeamsJS v.2.0 presenta una nueva API, navigateToApp, para navegar a páginas (y subpáginas) dentro de una aplicación de forma coherente entre hosts de aplicaciones (aplicación de Microsoft 365 y Outlook, además de Teams). Para las nuevas aplicaciones, siga las instrucciones actualizadas vinculadas en función del escenario de navegación:

• Vínculos profundos a la aplicación. Use pages.shareDeepLink (conocido como shareDeepLink antes de TeamsJS v.2.0) para generar y mostrar un vínculo que se pueda copiar para que el usuario lo comparta. Cuando se selecciona, se pide al usuario que instale la aplicación si aún no está instalada para el host de la aplicación.

• Navegación dentro de la aplicación. Use el nuevo pages.currentApp espacio de nombres para navegar dentro de la aplicación dentro de la aplicación de hospedaje. En concreto, la función navigateTo(NavigateWithinAppParams) para permitir la navegación a una pestaña específica dentro de la aplicación actual y la función navigateToDefaultPage() para navegar a la primera pestaña definida en el manifiesto de la aplicación. Para obtener más información, consulte Navegar dentro de una aplicación de pestaña.

  Estas API proporcionan el equivalente de navegar a un vínculo profundo (como se usó una vez el executeDeepLink ahora en desuso) sin necesidad de que la aplicación construya una dirección URL o administre diferentes formatos de vínculo profundo para distintos hosts de aplicaciones.

• Vínculos profundos fuera de la aplicación. Para obtener vínculos profundos desde la aplicación a varias áreas de su host actual, use las API con tipo proporcionadas por la biblioteca TeamsJS. Por ejemplo, use la calendar funcionalidad para abrir un cuadro de diálogo de programación o un elemento de calendario desde la aplicación.

  Para vínculos profundos desde la aplicación a otras aplicaciones que se ejecutan en el mismo host, use pages.navigateToApp.

  Para cualquier otro escenario de vinculación en profundidad externa, puede usar app.openLink, que proporciona una funcionalidad similar a la API ahora en desuso (a partir de TeamsJS v.2.0) executeDeepLink.

	Web				Escritorio					Móvil
					Windows					Android			iOS
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
pages.appButton	✓	✓	✓		✓	✓	✓
pages.backStack	✓	✓			✓	✓				✓	✓	✓	✓		✓
pages.currentApp		✓	✓	✓		✓	✓	✓	✓		✓	✓		✓	✓
pages.config	✓	✓			✓	✓		✓		✓		✓	✓		✓
pages.tabs	✓	✓			✓	✓

Nota:

Los métodos siguientes no se admiten en el cliente móvil de Teams:

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

pages.appButton

Referencia | Problemas conocidos

Proporciona API para interactuar con la parte del botón de aplicación del SDK.

pages.backStack

Referencia | Problemas conocidos

Proporciona API para controlar el historial de navegación del usuario.

pages.config

Referencia | Problemas conocidos

Proporciona API para interactuar con la parte específica de la configuración del SDK. Este objeto solo se puede usar en el marco de configuración.

pages.currentApp

Referencia | Problemas conocidos

Proporciona funciones para navegar sin necesidad de especificar el identificador de la aplicación.

pages.tabs

Referencia | Problemas conocidos

Proporciona API para consultar y navegar entre pestañas contextuales de una aplicación. A diferencia de las pestañas personales, las pestañas contextuales son páginas asociadas a un contexto específico, como canal o chat.

people

Referencia | Problemas conocidos

Namespace proporcionar funcionalidad para people picker API.

	Web				Escritorio					Móvil
					Windows					Android			iOS
people	✓	✓			✓	✓				✓			✓

profile

Referencia | Problemas conocidos

Vista previa. Namespace proporcionar funcionalidad relacionada con el perfil.

	Web				Escritorio					Móvil
					Windows					Android			iOS
		✓		✓		✓		✓	✓

Nota:

El profile.showProfile método no se admite en el cliente móvil de Teams.

search

Referencia | Problemas conocidos

Vista previa. Permite que la aplicación interactúe con el cuadro de búsqueda de la aplicación host de Microsoft 365. Al integrar la aplicación con el cuadro de búsqueda del host, los usuarios pueden buscar en la aplicación con el mismo cuadro de búsqueda que usan en otra parte de Teams, Outlook o la aplicación de Microsoft 365.

	Web				Escritorio					Móvil
					Windows					Android			iOS
	✓	✓		✓	✓	✓		✓	✓

secondaryBrowser

Referencia | Problemas conocidos

Vista previa. Namespace admitir experiencias de explorador desde la aplicación de la aplicación host. Por ejemplo, abrir una dirección URL en la aplicación host dentro de un explorador.

	Web				Escritorio					Móvil
					Windows					Android			iOS
.											✓	✓		✓	✓

settings

Referencia | Problemas conocidos

Obsoleto. Proporciona funcionalidad relacionada con la configuración. Use API equivalentes de las páginas para las nuevas aplicaciones.

	Web				Escritorio					Móvil
					Windows					Android			iOS
configuración	✓				✓					✓			✓

sharing

Referencia | Problemas conocidos

Namespace abrir un cuadro de diálogo de recurso compartido para el contenido web. Para obtener más información, consulte Compartir con Teams desde la pestaña o aplicación personal.

	Web				Escritorio					Móvil
					Windows					Android			iOS
uso compartido	✓	✓			✓	✓				✓			✓

Nota:

El sharing.shareWebContent método no se admite en el cliente móvil de Teams.

stageView

Referencia | Problemas conocidos

Vista previa. Namespace interactuar con la parte específica de Stageview de la biblioteca.

	Web				Escritorio					Móvil
					Windows					Android			iOS
distintivo stageView	✓	✓			✓	✓

tasks

Referencia | Problemas conocidos

La versión anterior de la funcionalidad para proporcionar diálogos modales (denominados módulos de tareas en TeamsJS v1.x) admite versiones anteriores a TeamsJS v2.8.0. Para las nuevas aplicaciones, use la funcionalidad de cuadro de diálogo .

	Web				Escritorio					Móvil
					Windows					Android			iOS
	✓				✓					✓			✓

Nota:

El task.getDefaultSizeIfNotProvided método no se admite en el cliente móvil de Teams.

teamsCore

Referencia | Problemas conocidos

Namespace que contiene el conjunto de API que admiten funcionalidades específicas de Teams.

	Web				Escritorio					Móvil
					Windows					Android			iOS
teamsCore	✓	✓			✓	✓				✓			✓

video

Referencia | Problemas conocidos

Vista previa. Namespace que representan la funcionalidad de los efectos de vídeo en la reunión.

	Web				Escritorio					Móvil
					Windows					Android			iOS
										✓			✓

Nota:

Los métodos siguientes no se admiten en el cliente móvil de Teams:

• video.notifySelectedVideoEffectChanged
• video.registerForVideoEffect

webStorage

Referencia | Problemas conocidos

Vista previa. Contiene funcionalidad para permitir que las aplicaciones web almacenen datos en la caché de vista web.

	Web				Escritorio					Móvil
					Windows					Android			iOS
					✓					✓			✓

Nota:

El webStorage.isWebStorageClearedOnUserLogOut método no se admite en el cliente móvil de Teams.

Vea también

• Ampliar las aplicaciones de Teams en Microsoft 365
• Extensión de una pestaña personal de Teams en una aplicación de Microsoft 365
• Referencia de la API de TeamsJS