Prise en charge des fonctionnalités TeamsJS dans Microsoft 365

À compter de la version 2.0.0, la bibliothèque de client JavaScript Microsoft Teams (TeamsJS) permet à certains types d’applications Teams de s’exécuter dans l’écosystème Microsoft 365. Les applications Microsoft 365 qui peuvent héberger des applications Teams (application Microsoft 365 et Outlook) ne prennent en charge qu’un sous-ensemble des types d’applications et des fonctionnalités que vous pouvez créer pour la plateforme Teams. Cette prise en charge s’étend au fil du temps.

Cet article détaille le niveau de prise en charge des fonctionnalités teamsJS version 2.x dans différentes applications hôtes. Pour plus d’informations sur ce qui a changé entre TeamsJS versions 1.x et 2.x, consultez Nouveautés de TeamsJS version 2.x.x.

Le tableau de fonctionnalités TeamsJS suivant répertorie les fonctionnalités TeamsJS (espaces de noms publics) et leur prise en charge dans les applications hôtes Microsoft 365. Certaines fonctionnalités sont marquées avec des badges Dépréciés ou Aperçu , qui ont les significations suivantes :

Insigne	Signification
	Cette fonctionnalité est en préversion et est susceptible d’être modifiée en fonction des commentaires. N’utilisez pas cette fonctionnalité en production.
	Cette fonctionnalité est déconseillée en faveur des fonctionnalités plus récentes, bien qu’elle soit prise en charge à des fins de compatibilité descendante. Pour les nouvelles applications, utilisez la fonctionnalité recommandée dans les notes d’utilisation de la fonctionnalité déconseillée.

Les hôtes Microsoft 365 sont signalés par les icônes de produit dans le tableau suivant :

Teams	Application Microsoft 365	Outlook

Pour plus d’informations sur les nouveaux Teams et Outlook, consultez le blog Outlook et l’adoption de Teams.

Dans les tableaux suivants, sélectionnez n’importe quelle fonctionnalité TeamsJS pour plus d’informations, notamment des documents de référence, des exemples, des notes d’utilisation et des limitations.

Notes

Les informations contenues dans les tableaux suivants sont dérivées des tests effectués avec TeamsJS v2.24 et des dernières versions de l’hôte disponibles pendant les tests. La prise en charge peut varier en fonction des modifications suivantes de l’hôte. Ces tables sont fournies pour vous aider à comprendre la prise en charge des fonctionnalités entre les hôtes. Toutefois, veillez toujours à utiliser les appels appropriés isSupported() dans votre code pour vérifier la prise en charge.

Fonctionnalités inter-hôtes

Le tableau suivant répertorie la prise en charge des applications hôtes pour les fonctionnalités TeamsJS qui peuvent s’exécuter en dehors de Teams.

Fonctionnalité TeamsJS	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
appli	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓
authentification	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
calendar				✓				✓	✓			✓			✓
Appel	✓	✓		✓	✓	✓			✓	✓			✓
badge de conversation	✓	✓		✓	✓	✓			✓	✓			✓
Badge du Presse-papiers		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓
boîte de dialogue	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
badge de géolocalisation		✓	✓			✓	✓	✓
mail				✓				✓	✓						✓
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
badge de profil		✓		✓		✓		✓	✓
badge de recherche	✓	✓		✓	✓	✓		✓	✓
secondaryBrowser											✓	✓		✓	✓

Fonctionnalités Teams uniquement

Le tableau suivant répertorie la prise en charge des fonctionnalités TeamsJS qui s’exécutent uniquement dans l’environnement Teams.

Fonctionnalité TeamsJS	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
badge appInitialization	✓				✓					✓			✓
	✓	✓			✓	✓				✓			✓
Menus					✓					✓			✓
people	✓	✓			✓	✓				✓			✓
paramètres	✓				✓					✓			✓
partage	✓	✓			✓	✓				✓			✓
Badge stageView	✓	✓			✓	✓
	✓				✓					✓			✓
teamsCore	✓	✓			✓	✓				✓			✓
Badge vidéo										✓			✓
badge webStorage					✓					✓			✓

Fonctionnalités en préversion en attente de prise en charge de l’hôte

Certaines fonctionnalités de la source sont en préversion et sont toujours en attente de support initial dans une ou plusieurs applications hôtes qui incluent barCode, média et réunion.

Plus loin dans cet article, vous trouverez plus d’informations sur chaque fonctionnalité de la bibliothèque de client JavaScript Teams.

app

Référence | Problèmes connus

Espace de noms pour interagir avec l’initialisation et le cycle de vie de l’application.

L’espace app de noms est pris en charge globalement sur tous les hôtes d’application et, par conséquent, n’a pas de isSupported fonction.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
application	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

appInitialization

Référence | Problèmes connus

Déconseillé. Espace de noms pour l’initialisation d’une application. Pour les nouvelles applications, utilisez app.initialize() à partir de la fonctionnalité d’application .

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
badge appInitialization	✓				✓					✓			✓

appInstallDialog

Référence | Problèmes connus

Espace de noms utilisé pour ouvrir une boîte de dialogue pour installer une application.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓

authentication

Référence | Problèmes connus

Espace de noms pour interagir avec la partie liée à l’authentification de la bibliothèque. Ce module est utilisé pour démarrer ou terminer des flux d’authentification.

L’espace authentication de noms est pris en charge globalement sur tous les hôtes d’application et, par conséquent, n’a pas de isSupported fonction.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
authentification	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

barCode

Référence | Problèmes connus

Aperçu. Espace de noms pour interagir avec la partie liée à l’analyse des codes-barres de la bibliothèque.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
barCode

calendar

Référence | Problèmes connus

Espace de noms fournissant des fonctionnalités liées au calendrier.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
calendrier				✓				✓	✓			✓			✓

call

Référence | Problèmes connus

Espace de noms fournissant des fonctionnalités pour démarrer un appel avec d’autres personnes.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
appeler	✓	✓		✓	✓	✓			✓	✓			✓

chat

Référence | Problèmes connus

Aperçu. Espace de noms fournissant des fonctionnalités pour démarrer une conversation avec d’autres personnes.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
	✓	✓		✓	✓	✓			✓	✓			✓

clipboard

Référence

Aperçu. Cette fonctionnalité permet aux utilisateurs de copier et de coller dans le Presse-papiers système.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
Badge du Presse-papiers		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓

dialog

Référence | Problèmes connus

Aperçu. Ce groupe de fonctionnalités permet aux applications d’afficher des dialogues modals (appelés modules de tâche dans TeamsJS v1.x). Il existe deux principaux types de dialogues : les dialogues basés sur une URL et les dialogues de carte adaptative. Les deux types de boîtes de dialogue s’affichent au-dessus de votre application, ce qui empêche l’interaction avec celle-ci pendant qu’elles s’affichent.

• Les boîtes de dialogue basées sur une URL vous permettent de spécifier une URL à partir de laquelle le contenu est affiché à l’intérieur de la boîte de dialogue. Pour les boîtes de dialogue URL, utilisez les fonctions et interfaces dans l’espace de noms url.
• Les boîtes de dialogue basées sur une carte adaptative vous permettent de fournir un code JSON décrivant une carte adaptative affichée dans la boîte de dialogue. Pour les boîtes de dialogue carte adaptative, utilisez les fonctions et interfaces dans l’espace de noms adaptiveCard.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
boîte de dialogue	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
dialog.adaptiveCard		✓	✓			✓	✓	✓		✓			✓
dialog.adaptiveCard.bot		✓				✓		✓		✓			✓
dialog.update	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
dialog.url	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
dialog.url.bot	✓	✓		✓	✓	✓		✓	✓	✓			✓

dialog.adaptiveCard

Référence | Problèmes connus

Aperçu. Sous-capabilité pour interagir avec les boîtes de dialogue de carte adaptative.

dialog.adaptiveCard.bot

Référence | Problèmes connus

Aperçu. Sous-capabilité pour l’interaction avec les boîtes de dialogue de carte adaptative qui doivent communiquer avec Bot Framework.

dialog.update

Référence | Problèmes connus

Aperçu. Espace de noms pour la mise à jour des boîtes de dialogue.

dialog.url

Référence | Problèmes connus

Aperçu. Sous-capabilité pour interagir avec des dialogues HTML.

dialog.url.bot

Référence | Problèmes connus

Aperçu. Sous-capabilité pour interagir avec des dialogues HTML qui doivent communiquer avec Bot Framework.

geoLocation

Référence | Problèmes connus

Aperçu. Espace de noms fournissant des fonctionnalités liées à l’emplacement. Il s’agit de la version la plus récente du module d’emplacement.

Les fonctionnalités qui nécessitent que l’utilisateur accorde des autorisations d’appareil (telles que la géolocalisation) sont partiellement prises en charge pour les applications exécutées en dehors de Teams. Les utilisateurs peuvent ajuster les autorisations d’application à partir de l’en-tête d’application lors de l’exécution dans Outlook et l’application Microsoft 365, ou à partir des paramètres de l’application sur mobile. Il est recommandé de modifier votre code pour vérifier la prise en charge d’Outlook et de Microsoft 365 :

• Appelez isSupported une fonctionnalité avant de l’utiliser.
• Intercepter et gérer les erreurs lors de l’appel des API TeamsJS et HTML5

Lorsqu’une API ne prend pas en charge ou ne génère pas d’erreur, ajoutez une logique pour échouer ou fournissez une solution de contournement. Par exemple :

• Diriger l’utilisateur vers le site web de votre application
• Demander à l’utilisateur d’utiliser l’application dans Teams pour terminer le flux
• Informer l’utilisateur que la fonctionnalité n’est pas encore disponible

Conseil

Vérifiez que le manifeste de votre application spécifie uniquement les autorisations d’appareil qu’il utilise.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
badge de géolocalisation		✓	✓			✓	✓	✓
geoLocation.map		✓				✓

geoLocation.map

Référence | Problèmes connus

Aperçu. Sous-capabilité fournissant des fonctionnalités liées à la carte.

location

Référence | Problèmes connus

Déconseillé. Espace de noms fournissant des fonctionnalités liées à l’emplacement (obtenir et afficher l’emplacement). Utilisez la géolocalisation pour les nouvelles applications.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
	✓	✓			✓	✓				✓			✓

mail

Référence | Problèmes connus

Espace de noms fournissant des fonctionnalités liées à l’e-mail.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
mail				✓				✓	✓						✓

media

Référence | Problèmes connus

Espace de noms fournissant des fonctionnalités liées aux fichiers image.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
média

meeting

Référence | Problèmes connus

Espace de noms fournissant des fonctionnalités d’application en réunion.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
réunion

Notes

Les méthodes suivantes ne sont pas prises en charge sur le client mobile Teams :

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

menus

Référence | Problèmes connus

Espace de noms pour interagir avec la partie liée au menu de la bibliothèque. Ce module est utilisé pour afficher la configuration de l’affichage, le menu Action et le menu de la barre de navigation.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
Menus					✓					✓			✓

pages

Référence | Problèmes connus

Partie liée à la navigation de la bibliothèque TeamsJS.

Avant teamsJS version 2.0, tous les scénarios de liaison approfondie étaient gérés à l’aide shareDeepLink de (pour générer un lien vers une partie spécifique de votre application) et executeDeepLink (pour accéder à un lien profond à partir ou au sein de votre application). TeamsJS v.2.0 introduit une nouvelle API, navigateToApp, pour accéder aux pages (et sous-pages) au sein d’une application de manière cohérente entre les hôtes d’application (Application Microsoft 365 et Outlook, en plus de Teams). Pour les nouvelles applications, suivez les instructions mises à jour liées en fonction de votre scénario de navigation :

• Liens profonds dans votre application. Utilisez pages.shareDeepLink (appelé shareDeepLink avant TeamsJS v.2.0) pour générer et afficher un lien pouvant être copié que l’utilisateur doit partager. Lorsque cette option est sélectionnée, l’utilisateur est invité à installer l’application si elle n’est pas déjà installée pour l’hôte de l’application.

• Navigation au sein de votre application. Utilisez le nouvel pages.currentApp espace de noms pour naviguer dans votre application au sein de l’application d’hébergement. Plus précisément, la fonction navigateTo(NavigateWithinAppParams) pour autoriser la navigation vers un onglet spécifique dans l’application actuelle et la fonction navigateToDefaultPage() pour accéder au premier onglet défini dans le manifeste de l’application. Pour plus d’informations, consultez Naviguer dans une application d’onglet.

  Ces API fournissent l’équivalent de la navigation vers un lien profond (comme le executeDeepLink désormais déprécié a été utilisé pour) sans que votre application construise une URL ou gère différents formats de lien profond pour différents hôtes d’application.

• Liens profonds à partir de votre application. Pour obtenir des liens profonds de votre application vers différentes zones de son hôte actuel, utilisez les API typées fournies par la bibliothèque TeamsJS. Par exemple, utilisez la calendar fonctionnalité pour ouvrir une boîte de dialogue de planification ou un élément de calendrier à partir de votre application.

  Pour les liens profonds de votre application vers d’autres applications s’exécutant sur le même hôte, utilisez pages.navigateToApp.

  Pour tout autre scénario de liaison approfondie externe, vous pouvez utiliser app.openLink, qui fournit des fonctionnalités similaires à l’API executeDeepLink désormais déconseillée (à partir de TeamsJS v.2.0).

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
pages.appButton	✓	✓	✓		✓	✓	✓
pages.backStack	✓	✓			✓	✓				✓	✓	✓	✓		✓
pages.currentApp		✓	✓	✓		✓	✓	✓	✓		✓	✓		✓	✓
pages.config	✓	✓			✓	✓		✓		✓		✓	✓		✓
pages.tabs	✓	✓			✓	✓

Notes

Les méthodes suivantes ne sont pas prises en charge sur le client mobile Teams :

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

pages.appButton

Référence | Problèmes connus

Fournit des API pour interagir avec la partie bouton de l’application du Kit de développement logiciel (SDK).

pages.backStack

Référence | Problèmes connus

Fournit des API pour gérer l’historique de navigation de l’utilisateur.

pages.config

Référence | Problèmes connus

Fournit des API pour interagir avec la partie spécifique à la configuration du Kit de développement logiciel (SDK). Cet objet est utilisable uniquement sur le frame de configuration.

pages.currentApp

Référence | Problèmes connus

Fournit des fonctions permettant de naviguer sans avoir à spécifier votre ID d’application.

pages.tabs

Référence | Problèmes connus

Fournit des API pour interroger et naviguer entre les onglets contextuels d’une application. Contrairement aux onglets personnels, les onglets contextuels sont des pages associées à un contexte spécifique, tel que le canal ou la conversation.

people

Référence | Problèmes connus

Espace de noms fournissant des fonctionnalités pour l’API Sélecteur de personnes.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
contacts	✓	✓			✓	✓				✓			✓

profile

Référence | Problèmes connus

Aperçu. Espace de noms fournissant des fonctionnalités liées au profil.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
		✓		✓		✓		✓	✓

Notes

La profile.showProfile méthode n’est pas prise en charge sur le client mobile Teams.

search

Référence | Problèmes connus

Aperçu. Permet à votre application d’interagir avec la zone de recherche de l’application Microsoft 365 hôte. En intégrant votre application à la zone de recherche de l’hôte, les utilisateurs peuvent effectuer des recherches dans votre application à l’aide de la même zone de recherche qu’ils utilisent ailleurs dans l’application Teams, Outlook ou Microsoft 365.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
badge de recherche	✓	✓		✓	✓	✓		✓	✓

secondaryBrowser

Référence | Problèmes connus

Aperçu. Espace de noms prenant en charge les expériences de navigateur dans l’application de l’application hôte. Par exemple, l’ouverture d’une URL dans l’application hôte à l’intérieur d’un navigateur.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
secondaryBrowser											✓	✓		✓	✓

settings

Référence | Problèmes connus

Déconseillé. Fournit des fonctionnalités liées aux paramètres. Utilisez des API équivalentes à partir des pages pour les nouvelles applications.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
paramètres	✓				✓					✓			✓

sharing

Référence | Problèmes connus

Espace de noms permettant d’ouvrir une boîte de dialogue de partage pour le contenu web. Pour plus d’informations, consultez Partager dans Teams à partir d’une application ou d’un onglet personnel.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
partage	✓	✓			✓	✓				✓			✓

Notes

La sharing.shareWebContent méthode n’est pas prise en charge sur le client mobile Teams.

stageView

Référence | Problèmes connus

Aperçu. Espace de noms pour interagir avec la partie spécifique de Stageview de la bibliothèque.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
Badge stageView	✓	✓			✓	✓

tasks

Référence | Problèmes connus

La version antérieure de la fonctionnalité de fourniture de dialogues modales (appelées modules de tâche dans TeamsJS v1.x) prend en charge les versions antérieures à TeamsJS v2.8.0. Pour les nouvelles applications, utilisez la fonctionnalité de boîte de dialogue .

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
	✓				✓					✓			✓

Notes

La task.getDefaultSizeIfNotProvided méthode n’est pas prise en charge sur le client mobile Teams.

teamsCore

Référence | Problèmes connus

Espace de noms contenant l’ensemble des API qui prennent en charge les fonctionnalités propres à Teams.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
teamsCore	✓	✓			✓	✓				✓			✓

video

Référence | Problèmes connus

Aperçu. Espace de noms représentant les fonctionnalités pour les effets vidéo en réunion.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
										✓			✓

Notes

Les méthodes suivantes ne sont pas prises en charge sur le client mobile Teams :

• video.notifySelectedVideoEffectChanged
• video.registerForVideoEffect

webStorage

Référence | Problèmes connus

Aperçu. Contient des fonctionnalités permettant aux applications web de stocker des données dans le cache webview.

	Web				Ordinateur de bureau					Mobile
					Windows					Android			iOS
badge webStorage					✓					✓			✓

Notes

La webStorage.isWebStorageClearedOnUserLogOut méthode n’est pas prise en charge sur le client mobile Teams.

Voir aussi

• Étendre Teams applications à travers Microsoft 365
• Étendre un onglet personnel Teams dans l’application Microsoft 365
• Informations de référence sur l’API TeamsJS