TeamsJS-Funktionsunterstützung für 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. Microsoft 365-Anwendungen, die Teams-Apps (Microsoft 365-App und Outlook) hosten können, unterstützen nur einen Teil 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 den folgenden Tabellen eine beliebige TeamsJS-Funktion aus, um weitere Details zu erhalten, einschließlich Referenzdokumenten, Beispielen, Verwendungshinweisen und Einschränkungen.

Hinweis

Die Informationen in den folgenden Tabellen werden von Tests abgeleitet, die mit TeamsJS v2.24 und den neuesten Hostversionen durchgeführt wurden, die während der Tests verfügbar sind. Die Unterstützung kann je nach nachfolgenden Hoständerungen variieren. Diese Tabellen werden bereitgestellt, um Ihnen zu helfen, die Funktionsunterstützung auf verschiedenen Hosts zu verstehen. Stellen Sie jedoch immer sicher, dass Sie die relevanten isSupported() Aufrufe in Ihrem Code verwenden, um die Unterstützung zu überprüfen.

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

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

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

Referenz | Bekannte Probleme

Namespace verwendet, um ein Dialogfeld zum Installieren einer Anwendung zu öffnen.

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

authentication

Referenz | Bekannte Probleme

Namespace, um mit dem authentifizierungsbezogenen Teil der Bibliothek zu interagieren. 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 | Bekannte Probleme

Vorschau. Namespace, um mit dem Barcodescan-bezogenen Teil der Bibliothek zu interagieren.

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS

calendar

Referenz | Bekannte Probleme

Namespace die Bereitstellung kalenderbezogener Funktionen.

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

call

Referenz | Bekannte Probleme

Namespace die Bereitstellung von Funktionen zum Starten eines Anrufs mit anderen Personen.

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

chat

Referenz | Bekannte Probleme

Vorschau. Namespace die Bereitstellung von Funktionen zum Starten eines Chats mit anderen Personen.

	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

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

Referenz | Bekannte Probleme

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

dialog.adaptiveCard.bot

Referenz | Bekannte Probleme

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

dialog.update

Referenz | Bekannte Probleme

Vorschau. Namespace zum Aktualisieren von Dialogfeldern.

dialog.url

Referenz | Bekannte Probleme

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

dialog.url.bot

Referenz | Bekannte Probleme

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

geoLocation

Referenz | Bekannte Probleme

Vorschau. Namespace die Bereitstellung standortbezogener Funktionen. 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. 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

Referenz | Bekannte Probleme

Vorschau. Unterkapazität, die kartenbezogene Funktionen bereitstellt.

location

Referenz | Bekannte Probleme

Veraltet. Namespace zur Bereitstellung standortbezogener Funktionen (Abrufen und Anzeigen des Standorts). Verwenden Sie geoLocation für neue Apps.

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

mail

Referenz | Bekannte Probleme

Namespace bereitstellung von E-Mail-bezogenen Funktionen.

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

media

Referenz | Bekannte Probleme

Namespace bereitstellung von Bilddateifunktionen.

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
media

meeting

Referenz | Bekannte Probleme

Namespace Bereitstellung von App-Funktionen in Besprechungen.

	Web				Desktop					Mobilgeräte
					Windows					Android			iOS
Treffen

Hinweis

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

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

menus

Referenz | Bekannte Probleme

Namespace, um mit dem menübezogenen Teil der Bibliothek zu interagieren. Dieses Modul wird verwendet, um Ansichtskonfiguration, Aktionsmenü und Navigationsleistenmenü anzuzeigen.

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

pages

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

Referenz | Bekannte Probleme

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

pages.backStack

Referenz | Bekannte Probleme

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

pages.config

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

Referenz | Bekannte Probleme

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

pages.tabs

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

Referenz | Bekannte Probleme

Namespace Bereitstellung von Funktionen für die Personenauswahl-API.

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

profile

Referenz | Bekannte Probleme

Vorschau. Namespace bereitstellung profilbezogener Funktionen.

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

Hinweis

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

search

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

Referenz | Bekannte Probleme

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

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

settings

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

Referenz | Bekannte Probleme

Namespace, um ein Freigabedialogfeld für Webinhalte zu öffnen. 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

Referenz | Bekannte Probleme

Vorschau. Namespace, um mit dem stageview-spezifischen Teil der Bibliothek zu interagieren.

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

tasks

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

Referenz | Bekannte Probleme

Namespace, die den Satz von APIs enthalten, die Teams-spezifische Funktionen unterstützen.

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

video

Referenz | Bekannte Probleme

Vorschau. Namespace, die die Funktionalität 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

Referenz | 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
• TeamsJS-API-Referenz