Unterstützung von TeamsJS-Funktionen in Microsoft 365

Ab Version 2.0.0 ermöglicht die Microsoft Teams JavaScript-Clientbibliothek (TeamsJS) die Ausführung bestimmter Arten 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 der folgenden Tabelle gekennzeichnet:

Teams	Microsoft 365-App	Outlook

Weitere Informationen zu den neuen Teams und Outlook finden Sie unter Outlook-Blog und Teams-Einführung.

Wählen Sie in der folgenden Tabelle eine beliebige TeamsJS-Funktion aus, um weitere Details zu erhalten, einschließlich Referenzdokumenten, Beispielen, Verwendungshinweisen und Einschränkungen.

Hostübergreifende Funktionen

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

TeamsJS-Funktion	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
App	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓
Authentifizierung	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
Kalender				✓				✓	✓			✓			✓
call	✓	✓		✓	✓	✓			✓	✓			✓
	✓	✓		✓	✓	✓			✓	✓			✓
Badge der Zwischenablage		✓	✓	✓		✓	✓	✓	✓					✓	✓
	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
			✓				✓	✓
Mail				✓				✓	✓						✓
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
				✓				✓	✓
	✓	✓			✓	✓		✓
secondaryBrowser											✓	✓		✓	✓

Nur Teams-Funktionen

Die folgende Tabelle enthält die Unterstützung für TeamsJS-Funktionen, die nur in der Teams-Umgebung ausgeführt werden.

TeamsJS-Funktion	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
appInitialization	✓				✓					✓			✓
	✓				✓					✓			✓
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 und Besprechung enthalten.

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

app

Verweis | Bekannte Probleme

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

Verweis | Bekannte Probleme

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 | Bekannte Probleme

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

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

authentication

Verweis | Bekannte Probleme

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

Verweis | Bekannte Probleme

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

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS

calendar

Verweis | Bekannte Probleme

Namespace, der kalenderbezogene Funktionen bereitstellt.

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

call

Verweis | Bekannte Probleme

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

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

chat

Verweis | Bekannte Probleme

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

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

clipboard

Referenz

Vorschau. Diese Funktion ermöglicht benutzern das Kopieren und Einfügen in die Systemzwingablage.

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

dialog

Verweis | Bekannte Probleme

Vorschau. Mit dieser Gruppe von Funktionen können Apps modale Dialoge anzeigen (in TeamsJS v1.x als Aufgabenmodule bezeichnet). 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 | Bekannte Probleme

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

dialog.adaptiveCard.bot

Verweis | Bekannte Probleme

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

dialog.update

Verweis | Bekannte Probleme

Vorschau. Namespace zum Aktualisieren von Dialogfeldern.

dialog.url

Verweis | Bekannte Probleme

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

dialog.url.bot

Verweis | Bekannte Probleme

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

geoLocation

Verweis | Bekannte Probleme

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 | Bekannte Probleme

Vorschau. Unterkapazität, die kartenbezogene Funktionen bereitstellt.

location

Verweis | Bekannte Probleme

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

Verweis | Bekannte Probleme

Namespace, der E-Mail-bezogene Funktionen bereitstellt.

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

media

Verweis | Bekannte Probleme

Namespace, der bilddateibezogene Funktionen bereitstellt.

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
media

meeting

Verweis | Bekannte Probleme

Namespace, der App-Funktionen in Besprechungen bereitstellt.

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
Sitzung

Hinweis

Die folgenden Methoden werden auf dem mobilen Teams-Client nicht unterstützt:

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

menus

Verweis | Bekannte Probleme

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 | Bekannte Probleme

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	✓	✓			✓	✓

Hinweis

Die folgenden Methoden werden auf dem mobilen Teams-Client nicht unterstützt:

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

pages.appButton

Verweis | Bekannte Probleme

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

pages.backStack

Verweis | Bekannte Probleme

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

pages.config

Verweis | Bekannte Probleme

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

pages.currentApp

Verweis | Bekannte Probleme

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

pages.tabs

Verweis | Bekannte Probleme

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 | Bekannte Probleme

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

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

profile

Verweis | Bekannte Probleme

Vorschau. Namespace, der profilbezogene Funktionen bereitstellt.

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
				✓				✓	✓

Hinweis

Die profile.showProfile -Methode wird auf dem mobilen Teams-Client nicht unterstützt.

search

Verweis | Bekannte Probleme

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

Verweis | Bekannte Probleme

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

Verweis | Bekannte Probleme

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 | Bekannte Probleme

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	✓	✓			✓	✓				✓			✓

Hinweis

Die sharing.shareWebContent -Methode wird auf dem mobilen Teams-Client nicht unterstützt.

stageView

Verweis | Bekannte Probleme

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

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

tasks

Verweis | Bekannte Probleme

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

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

Hinweis

Die task.getDefaultSizeIfNotProvided -Methode wird auf dem mobilen Teams-Client nicht unterstützt.

teamsCore

Verweis | Bekannte Probleme

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

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

video

Verweis | Bekannte Probleme

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

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
										✓			✓

Hinweis

Die folgenden Methoden werden auf dem mobilen Teams-Client nicht unterstützt:

• video.notifySelectedVideoEffectChanged
• video.registerForVideoEffect

webStorage

Verweis | Bekannte Probleme

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

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
					✓					✓			✓

Hinweis

Die webStorage.isWebStorageClearedOnUserLogOut -Methode wird auf dem mobilen Teams-Client nicht unterstützt.

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