Unterstützung von TeamsJS-Funktionen in Microsoft 365

Ab Version 2.0.0 ermöglicht die Teams JavaScript-Clientbibliothek (TeamsJS) die Ausführung bestimmter Typen von Teams-Apps im gesamten Microsoft 365-Ökosystem. Derzeit unterstützen Microsoft 365-Anwendungen, die Teams-Apps (Microsoft 365-App und Outlook) hosten können, nur eine Teilmenge der Anwendungstypen und Funktionen, die Sie für die Teams-Plattform erstellen können. Diese Unterstützung wird im Laufe der Zeit erweitert.

In diesem Artikel wird der Grad der Unterstützung von TeamsJS Version 2.x-Funktionen für verschiedene Hostanwendungen beschrieben. Weitere Informationen dazu, was sich zwischen den TeamsJS-Versionen 1.x und 2.x geändert hat, finden Sie unter Neuerungen in TeamsJS Version 2.x.x.

In der folgenden Tabelle der TeamsJS-Funktionen sind Die TeamsJS-Funktionen (öffentliche Namespaces) und deren Unterstützung für Microsoft 365-Hostanwendungen aufgeführt. Einige Funktionen sind mit Signalen als veraltet oder Vorschau gekennzeichnet, die folgende Bedeutungen haben:

Abzeichen	Bedeutung
	Diese Funktion befindet sich in der Vorschauphase und kann basierend auf Feedback geändert werden. Verwenden Sie diese Funktion nicht in der Produktion.
	Diese Funktion ist zugunsten neuerer Funktionen veraltet, wird jedoch aus Gründen der Abwärtskompatibilität unterstützt. Verwenden Sie für neue Apps die in den Verwendungshinweisen der veralteten Funktion empfohlene Funktion.

Microsoft 365-Hosts werden durch die Produktsymbole in den folgenden Tabellen gekennzeichnet:

Microsoft Teams	Microsoft 365-App	Microsoft Outlook

Vorschauversionen für Teams und Outlook (gestartet durch Testen der neuen Teams und Testen der neuen Outlook-Umschaltsteuerelemente in Teams bzw. Outlook-Clients) haben unterschiedliche Supportebenen. Die Vorschauversionen werden durch die folgenden PRE-Symbole (Vorschau) festgelegt:

Microsoft Teams (Vorschau)	Microsoft Outlook (Vorschau)

Einträge, die mit einem Häkchen und Sternchen (✓*) gekennzeichnet sind, geben an, dass die Unterstützung für diesen Host nur für Vorschaugruppen verfügbar ist (registriert in Microsoft 365 Targeted Releases für Webclients oder mit Beta-Kanal-Apps , die für Desktopclients installiert sind). Wählen Sie eine beliebige TeamsJS-Funktion aus, um weitere Details zu erhalten, einschließlich Referenzdokumenten, Beispielen und Verwendungshinweisen.

Hostübergreifende Funktionen

Die folgende Tabelle enthält die Unterstützung von Hostanwendungen für TeamsJS-Funktionen, die außerhalb von Microsoft Teams ausgeführt werden können.

TeamsJS-Funktion	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
App	✓	✓	✓*	✓	✓*	✓	✓*	✓*	✓	✓	✓*	✓	✓	✓*
appInstallDialog	✓	✓		✓	✓*	✓			✓			✓
Authentifizierung	✓	✓	✓*	✓	✓*	✓	✓*	✓*	✓	✓	✓*	✓	✓	✓*
Kalender							✓*				✓*			✓*
	✓	✓	✓*	✓	✓*	✓	✓*		✓			✓
		✓			✓*	✓
Mail			✓*				✓*				✓*			✓*
pages	✓	✓	✓*	✓	✓*	✓	✓*		✓	✓	✓*	✓	✓	✓*
							✓*
			✓*		✓*		✓*
secondaryBrowser											✓*

Nur Teams-Funktionen

In der folgenden Tabelle ist die Unterstützung für TeamsJS-Funktionen aufgeführt, die nur in der Microsoft Teams-Umgebung ausgeführt werden.

TeamsJS-Funktion	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
appInitialization	✓			✓					✓			✓
call	✓			✓					✓			✓
	✓			✓	✓*				✓			✓
	✓			✓					✓			✓
Menüs									✓			✓
people	✓			✓	✓*				✓			✓
Badge	✓			✓					✓			✓
Teilens	✓			✓	✓*
	✓			✓	✓*
	✓			✓					✓			✓
teamsCore	✓			✓	✓*
	✓			✓					✓			✓
webStorage-Badge				✓					✓			✓

Vorschaufunktionen, die auf Hostunterstützung warten

Einige Funktionen in der Quelle befinden sich in der frühen Vorschauphase und warten noch auf die erste Unterstützung in einer oder mehreren Hostanwendungen, die BarCode, Medien, Besprechungen und Suche umfassen.

Weiter unten in diesem Artikel finden Sie weitere Informationen zu den einzelnen Funktionen der Teams JavaScript-Clientbibliothek.

app

Verweis | Beispiel

Namespace für die Interaktion mit der App-Initialisierung und dem Lebenszyklus.

Der app Namespace wird global auf allen Anwendungshosts unterstützt und verfügt daher nicht über eine isSupported Funktion.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
App	✓	✓	✓*	✓	✓*	✓	✓*	✓*	✓	✓	✓*	✓	✓	✓*

appInitialization

Referenz

Veraltet. Namespace zum Initialisieren einer App. Verwenden Sie für neue Apps app.initialize() aus der App-Funktion .

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
appInitialization	✓			✓					✓			✓

appInstallDialog

Verweis | Beispiel

Namespace, der zum Öffnen eines Dialogfelds zum Installieren einer Anwendung verwendet wird.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
appInstallDialog	✓	✓		✓	✓*	✓			✓			✓

authentication

Referenz

Namespace für die Interaktion mit dem authentifizierungsbezogenen Teil der Bibliothek. Dieses Modul wird zum Starten oder Abschließen von Authentifizierungsflows verwendet.

Der authentication Namespace wird global auf allen Anwendungshosts unterstützt und verfügt daher nicht über eine isSupported Funktion.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
Authentifizierung	✓	✓	✓*	✓	✓*	✓	✓*	✓*	✓	✓	✓*	✓	✓	✓*

barCode

Referenz

Vorschau. Namespace für die Interaktion mit dem Barcodescan-bezogenen Teil der Bibliothek.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS

calendar

Referenz

Namespace, der kalenderbezogene Funktionen bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
Kalender							✓*				✓*			✓*

call

Verweis | Beispiel

Namespace, der Funktionen zum Starten eines Anrufs mit anderen personen bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
call	✓			✓					✓			✓

chat

Verweis | Beispiel

Vorschau. Namespace, der Funktionen bereitstellt, um einen Chat mit anderen zu starten.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
	✓			✓	✓*				✓			✓

dialog

Verweis | Beispiel

Vorschau. Mit dieser Gruppe von Funktionen können Apps modale Aufgabenmodule (Dialoge) anzeigen. Es gibt zwei primäre Dialogtypen: URL-basierte Dialoge und Dialogfelder für adaptive Karten. Beide Arten von Dialogfeldern werden oben in Ihrer App angezeigt, wodurch die Interaktion mit Ihrer App während der Anzeige verhindert wird.

• IN URL-basierten Dialogfeldern können Sie eine URL angeben, aus der der Inhalt innerhalb des Dialogfelds angezeigt wird. Verwenden Sie für URL-Dialogfelder die Funktionen und Schnittstellen im URL-Namespace.
• Mit auf adaptiven Karten basierenden Dialogfeldern können Sie JSON-Code bereitstellen, der eine adaptive Karte beschreibt, die im Dialogfeld angezeigt wird. Verwenden Sie für Dialogfelder für adaptive Karten die Funktionen und Schnittstellen im adaptiveCard-Namespace.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
	✓	✓	✓*	✓	✓*	✓	✓*		✓			✓
dialog.adaptiveCard					✓*
dialog.adaptiveCard.bot					✓*
dialog.update	✓	✓	✓*	✓	✓*	✓	✓*
dialog.url	✓	✓	✓*	✓	✓*	✓	✓*		✓			✓
dialog.url.bot	✓			✓	✓*		✓*		✓			✓

dialog.adaptiveCard

Verweis | Beispiel

Vorschau. Unterkapazität für die Interaktion mit Dialogfeldern für adaptive Karten.

dialog.adaptiveCard.bot

Referenz

Vorschau. Unterkapazität für die Interaktion mit Dialogen mit adaptiven Karten, die mit bot Framework kommunizieren müssen.

dialog.update

Verweis | Beispiel

Vorschau. Namespace zum Aktualisieren von Dialogfeldern.

dialog.url

Verweis | Beispiel

Vorschau. Unterkapazität für die Interaktion mit HTML-basierten Dialogen.

dialog.url.bot

Verweis | Beispiel

Vorschau. Unterkapazität für die Interaktion mit HTML-basierten Dialogen, die mit Bot Framework kommunizieren müssen.

geoLocation

Verweis | Beispiel

Vorschau. Namespace, der standortbezogene Funktionen bereitstellt. Dies ist die neuere Version des Standortmoduls.

Funktionen, bei denen der Benutzer Geräteberechtigungen (z. B. geoLocation) erteilen muss, werden teilweise für Apps unterstützt, die außerhalb von Teams ausgeführt werden. Benutzer können App-Berechtigungen über den App-Header anpassen, wenn sie in Outlook und Microsoft 365-App ausgeführt werden, oder über app-Einstellungen auf mobilgeräten. Es wird empfohlen, Ihren Code zu ändern, um die Unterstützungsfähigkeit von Outlook und Microsoft 365 zu überprüfen:

• Rufen Sie isSupported eine Funktion auf, bevor Sie sie verwenden.
• Abfangen und Behandeln von Fehlern beim Aufrufen von TeamsJS- und HTML5-APIs

Wenn eine API keinen Fehler unterstützt oder generiert, fügen Sie Logik hinzu, um einen Fehler zu verursachen, oder stellen Sie eine Problemumgehung bereit. Zum Beispiel:

• Weiterleiten des Benutzers zur Website Ihrer App
• Weisen Sie den Benutzer an, die App in Teams zu verwenden, um den Flow abzuschließen.
• Benachrichtigen des Benutzers, dass die Funktionalität noch nicht verfügbar ist

Tipp

Stellen Sie sicher, dass Ihr App-Manifest nur die verwendeten Geräteberechtigungen angibt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
		✓			✓*	✓
geoLocation.map

geoLocation.map

Verweis | Beispiel

Vorschau. Unterkapazität, die kartenbezogene Funktionen bereitstellt.

location

Referenz

Veraltet. Namespace, der standortbezogene Funktionen bereitstellt (Standort abrufen und anzeigen). Verwenden Sie geoLocation für neue Apps.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
	✓			✓					✓			✓

mail

Referenz

Namespace, der E-Mail-bezogene Funktionen bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
mail			✓*				✓*				✓*			✓*

media

Referenz

Namespace, der bilddateibezogene Funktionen bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
media

meeting

Referenz

Namespace, der App-Funktionen in Besprechungen bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
Sitzung

menus

Verweis | Beispiel

Namespace für die Interaktion mit dem menübezogenen Teil der Bibliothek. Dieses Modul wird verwendet, um Ansichtskonfiguration, Aktionsmenü und Navigationsleistenmenü anzuzeigen.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
Menüs									✓			✓

pages

Verweis | Beispiel

Navigationsbezogener Teil der TeamsJS-Bibliothek.

Vor TeamsJS Version 2.0 wurden alle Deep Linking-Szenarien mit shareDeepLink (zum Generieren eines Links zu einem bestimmten Teil Ihrer App) und executeDeepLink (um von oderinnerhalb Ihrer App zu einem Deep-Link zu navigieren) behandelt. TeamsJS v.2.0 führt eine neue API ein, navigateToAppdie das Navigieren zu Seiten (und Unterseiten) innerhalb einer App auf einheitliche Weise über App-Hosts hinweg (Microsoft 365-App und Outlook, zusätzlich zu Teams) bietet. Befolgen Sie für neue Apps abhängig von Ihrem Navigationsszenario die verknüpften aktualisierten Anleitungen:

• Deep Links zu Ihrer App. Verwenden Sie pages.shareDeepLink (vor TeamsJS v.2.0 als shareDeepLink bezeichnet), um einen kopierbaren Link zu generieren und anzuzeigen, den der Benutzer freigeben kann. Wenn diese Option ausgewählt ist, wird der Benutzer aufgefordert, die App zu installieren, wenn sie noch nicht für den Anwendungshost installiert ist.

• Navigation in Ihrer App. Verwenden Sie den neuen pages.currentApp Namespace, um innerhalb Ihrer App innerhalb der Hostinganwendung zu navigieren. Insbesondere die Funktion navigateTo(NavigateWithinAppParams) , um die Navigation zu einer bestimmten Registerkarte innerhalb der aktuellen App zu ermöglichen, und die Funktion navigateToDefaultPage() , um zur ersten Registerkarte zu navigieren, die im Manifest der App definiert ist. Weitere Informationen finden Sie unter Navigieren innerhalb einer Registerkarten-App.

  Diese APIs bieten das Äquivalent zum Navigieren zu einem Deep Link (wie die jetzt veraltete executeDeepLink-Instanz , für die einst verwendet wurde), ohne dass Ihre App eine URL erstellen oder verschiedene Deep Link-Formate für verschiedene Anwendungshosts verwalten muss.

• Deep-Links aus Ihrer App. Verwenden Sie die typisierten APIs, die von der TeamsJS-Bibliothek bereitgestellt werden, um DeepLinks von Ihrer App zu verschiedenen Bereichen des aktuellen Hosts zu erhalten. Verwenden Sie beispielsweise die calendar -Funktion, um ein Planungsdialogfeld oder ein Kalenderelement aus Ihrer App zu öffnen.

  Verwenden Sie pages.navigateToApp für Deep-Links von Ihrer App zu anderen Apps, die auf demselben Host ausgeführt werden.

  Für alle anderen externen Deep Linking-Szenarien können Sie app.openLink verwenden, das eine ähnliche Funktionalität wie die (seit TeamsJS v.2.0) veraltete executeDeepLink-API bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
pages	✓	✓	✓*	✓	✓*	✓	✓*	✓*	✓	✓	✓*	✓	✓	✓*
pages.appButton	✓	✓		✓	✓*	✓
pages.backStack	✓			✓	✓*				✓			✓
pages.currentApp		✓				✓				✓			✓	✓*
pages.config	✓			✓	✓*				✓			✓
pages.tabs	✓			✓	✓*

pages.appButton

Verweis | Beispiel

Stellt APIs für die Interaktion mit dem App-Schaltflächenteil des SDK bereit.

pages.backStack

Verweis | Beispiel

Stellt APIs für die Verarbeitung des Navigationsverlaufs des Benutzers bereit.

pages.config

Referenz

Stellt APIs für die Interaktion mit dem konfigurationsspezifischen Teil des SDK bereit. Dieses Objekt kann nur im Konfigurationsframe verwendet werden.

pages.currentApp

Verweis | Beispiel

Stellt Funktionen für die Navigation bereit, ohne Ihre Anwendungs-ID angeben zu müssen.

pages.tabs

Referenz

Stellt APIs zum Abfragen und Navigieren zwischen kontextbezogenen Registerkarten einer Anwendung bereit. Im Gegensatz zu persönlichen Registerkarten sind Kontextregisterkarten Seiten, die einem bestimmten Kontext zugeordnet sind, z. B. Kanal oder Chat.

people

Verweis | Beispiel

Namespace, der Funktionen für Personen Auswahl-API bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
Kontakte	✓			✓	✓*				✓			✓

profile

Referenz

Vorschau. Namespace, der profilbezogene Funktionen bereitstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
							✓*

search

Referenz

Vorschau. Ermöglicht Ihrer Anwendung die Interaktion mit dem Suchfeld der Host-Microsoft 365-Anwendung. Durch die Integration Ihrer Anwendung in das Suchfeld des Hosts können Benutzer Ihre App mit demselben Suchfeld durchsuchen, das sie an anderer Stelle in Teams, Outlook oder Microsoft 365-App verwenden.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
			✓*		✓*		✓*

secondaryBrowser

Referenz

Vorschau. Namespace, der die In-App-Browserfunktionen der Host-App unterstützt. Beispiel: Öffnen einer URL in der Host-App in einem Browser.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
secondaryBrowser											✓*

settings

Referenz

Veraltet. Stellt einstellungenbezogene Funktionen bereit. Verwenden Sie entsprechende APIs aus den Seiten für neue Apps.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
Badge	✓			✓					✓			✓

sharing

Verweis | Beispiel

Namespace zum Öffnen eines Freigabedialogfelds für Webinhalte. Weitere Informationen finden Sie unter Freigeben für Teams von einer persönlichen App oder Registerkarte.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
sharing	✓			✓	✓*

stageView

Verweis | Beispiel

Vorschau. Namespace für die Interaktion mit dem spezifischen Teil der Phasenansicht der Bibliothek.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
	✓			✓	✓*

tasks

Referenz

Die frühere Version der Funktion zum Bereitstellen modaler Dialoge (Aufgabenmodul) unterstützt Versionen vor TeamsJS v2.8.0. Verwenden Sie für neue Apps die Dialogfunktion .

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
	✓			✓					✓			✓

teamsCore

Verweis | Beispiel

Namespace, der den Satz von APIs enthält, die Teams-spezifische Funktionen unterstützen.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
teamsCore	✓			✓	✓*

video

Verweis | Beispiel

Vorschau. Namespace, der Funktionen für Videoeffekte in Besprechungen darstellt.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
	✓			✓					✓			✓

webStorage

Verweis | Beispiel

Vorschau. Enthält Funktionen, mit denen Web-Apps Daten im Webviewcache speichern können.

	Web			Desktop					Mobilgeräte
				Windows					Android			iOS
				✓					✓			✓

Codebeispiel

Beispielname	Beschreibung	Quelle
TeamsJS-Funktionsprüfung	Beispielanwendung zur Veranschaulichen der Funktionen der TeamsJS-Bibliothek v2 in Microsoft Teams-Apps, die über Outlook und Microsoft 365 erweitert wurden.	TypeScript

Siehe auch

• Erweitern von Teams-Apps auf Microsoft 365
• Erweitern einer persönlichen Teams-Registerkarte über eine Microsoft 365-App
• Übersicht über die Teams JavaScript-Clientbibliothek
• TeamsJS-API-Referenz