In Besprechung freigeben

In Besprechung freigeben ermöglicht Benutzern das Freigeben von Dokumenten oder Web-Apps von Drittanbietern für die Besprechungsphase. Die Besprechungsteilnehmer können mit den Web-Apps von Drittanbietern zusammenarbeiten und interagieren oder die Dokumente gemeinsam bearbeiten.

Die folgende Abbildung zeigt die Schaltfläche In Besprechung teilen in der Web-App:

Wenn ein Benutzer während der Besprechung die Schaltfläche In Besprechung teilen aus der Web-App oder dem Dokument eines Drittanbieters auswählt, wird ein Deep-Link zur Besprechungsphase gestartet und die App als Webansicht in der Besprechungsphase geöffnet. Im Folgenden finden Sie das Deep Link-Format:

msteams:/l/meeting-share?deeplinkId={GUID}&fqdn={string}&lm=deeplink&appContext={json encoded app context}

Voraussetzungen

• Damit die Besprechungsteilnehmer mit Web-Apps oder Dokumenten von Drittanbietern interagieren können, muss eine Besprechungserweiterung der App oder des Dokuments in ihrem Teams-Client installiert sein. Wenn sie keine Besprechungserweiterung haben, fordert Teams die Teilnehmer auf, die Besprechungserweiterung zu installieren.
• Um die gesamte App für die Bühne freizugeben, müssen Sie und meetingSidePanel als Rahmenkontexte im App-Manifest konfigurierenmeetingStage. Andernfalls können Besprechungsteilnehmer den Inhalt möglicherweise nicht auf der Bühne anzeigen.

Aktivieren der Freigabe in einer Besprechung

Im Folgenden werden drei verschiedene Methoden zum Aktivieren der Freigabe in einer Besprechung aufgeführt. Sie können eine der Methoden verwenden, je nachdem, wie viel Steuerelement Sie für die Schaltflächen "In Besprechung teilen " verwenden möchten, die auf Ihrer Webseite angezeigt werden:

Methode 1

Diese Methode ist die einfachste Möglichkeit, die Freigabe in Besprechungsschaltflächen mit minimalen Anpassungen anzuzeigen. Sie können die Stile, Größe und Sprachen der Schaltfläche anpassen.

Sie können Ihre Webseite scannen, um beliebige HTML-Elemente mit dem Klassennamen vom Typ teams-share-in-meeting-button zu suchen und dynamisch schaltflächen In Besprechung teilen auf Ihrer Seite zu generieren.

1. Fügen Sie das launcher.js Skript auf Ihrer Webseite hinzu.

   <script async defer src="https://teams.microsoft.com/share/launcher.js"></script>
   

2. Fügen Sie auf Ihrer Webseite ein HTML-Element mit im teams-share-in-meeting-buttonclass -Attribut, der App-ID (aus dem Manifest) im data-app-id Attribut und dem Link hinzu, der data-href im Attribut freigegeben werden soll. Sie können auch die data-entity-name Attribute und data-entity-description einschließen.

   <div
     class="teams-share-in-meeting-button"
     data-href="https://<link-to-be-shared>"
     data-app-id="<app-id>"
     data-entity-name="<app-name>"
     data-entity-description="<app-content-description>"
     >
   </div>
   

3. Im Folgenden sind die zusätzlichen Attribute aufgeführt, um die Schaltfläche "In Besprechung teilen" anzupassen:

   • data-button-type: Gibt die Hintergrundfarbe der Schaltfläche (primaryShareInMeeting oder secondaryShareInMeeting) an.
   • data-button-size: Gibt die Größe der Schaltfläche in Pixel an.
   • data-target: Gibt an, ob der Link im selben Fenster, auf der neuen Registerkarte oder in einem neuen Fenster geöffnet wird.
   • data-locale: Gibt die gewünschte Benutzersprache an.

Methode 2

Mit dieser Methode können Sie steuern, welche Schaltfläche dynamisch gerendert werden soll oder wann das Skript ausgeführt wird. Das Skript wird nur ausgeführt, wenn window.shareToMicrosoftTeams.renderButtons() aufgerufen wird. Sie können bestimmte HTML-Elemente über die renderButtons({elements: [], shareInMeetingElements: [shareInMeetingButton]) API übergeben. Sie können die Stile, Größe und Sprachen der Schaltfläche anpassen.

Die async shareToMicrosoftTeams.renderButtons(options) API rendert alle Freigabeschaltflächen mit dem Klassennamen teams-share-button oder teams-share-in-meeting-button auf der Seite. Wenn ein options (optional) Objekt mit einer Liste von Elementen bereitgestellt wird, wie im folgenden Code gezeigt, werden diese Elemente in die Schaltflächen Freigeben oder In Besprechung teilen gerendert.

options (optional): { elements?: HTMLElement[], shareInMeetingElements?: HTMLElement[] }

1. Fügen Sie das launcher.js Skript auf Ihrer Webseite hinzu.

   <script async defer src="https://teams.microsoft.com/share/launcher.js" onload="onLoadComplete()"></script>
   

2. Erstellen Sie ein HTML-Element, und geben Sie die erforderlichen Attribute an. Nachdem das Startprogrammskript vollständig geladen wurde, stellen Sie sicher, dass die Renderinglogik ausgeführt wird.

   async function onLoadComplete() {
      const shareInMeetingButton = document.createElement("div");
      shareInMeetingButton.setAttribute("data-app-id", "<app-id>");
      shareInMeetingButton.textContent = "Share Test App"
      shareInMeetingButton.setAttribute("data-href", "<app-content-url>");
      shareInMeetingButton.setAttribute("data-button-type", "secondaryShareInMeeting");
      shareInMeetingButton.setAttribute("data-locale", "fr-CA");
      await window.shareToMicrosoftTeams.renderButtons({elements: [], shareInMeetingElements: [shareInMeetingButton]});
   }  
   

Methode 3

Sie können diese Methode verwenden, um die vollständige Kontrolle darüber zu haben, wie das Skript aufgerufen wird und wann die Schaltfläche mithilfe der window.shareToMicrosoftTeams.shareInMeetingClickHandler API generiert werden soll. Sie können steuern, wie und wo die Schaltflächen generiert werden. Sie müssen die window.shareToMicrosoftTeams.shareInMeetingClickHandler API nur an das onclick -Attribut der Schaltfläche anfügen. Es kann an einen Link, eine Schaltfläche, ein Dropdownmenü usw. angefügt werden. Sie haben die vollständige Kontrolle darüber, wie die Benutzeroberfläche angezeigt wird.

Die async shareInMeetingClickHandler(content: IShareInMeetingContent) API erstellt einen Rückrufhandler für die Schaltfläche "In Besprechung teilen", der durch Auswählen einer Schaltfläche oder eines Menüs ausgeführt werden kann.

1. Fügen Sie das launcher.js Skript auf Ihrer Webseite hinzu.

   <script async defer src="https://teams.microsoft.com/share/launcher.js" onload="onLoadComplete()"></script>
   

2. Erstellen Sie ein HTML-Element, und fügen Sie dem -onClickAttribut hinzushareToMicrosoftTeams.shareInMeetingClickHandler. Nachdem das Startprogrammskript vollständig geladen wurde, stellen Sie sicher, dass die OnClick-Logik erstellt wird.

   async function onLoadComplete() {
      var customShareInMeetingButton = document.createElement("a");
      customShareInMeetingButton.onclick = window.shareToMicrosoftTeams.shareInMeetingClickHandler({
      url: "<app-content-url>",
      appId: "<app-id>",
      entityName: "<app-entity-name>",
      entityDescription: "<app-content-description>",
      });
   }
   

Im Folgenden sind die launcher.js Definitionen aufgeführt:

Eigenschaft	HTML-Attribut	Typ	Erforderlich	Standard	Beschreibung
url	data-href	Zeichenfolge	Ja	–	URL des app-Inhalts, der freigegeben werden soll.
appId	data-app-id	Zeichenfolge	Ja	–	ID der app, die freigegeben werden soll.
entityName	data-entity-name	Zeichenfolge	Nein	–	Name der App-Entität.
entityDescription	data-entity-description	Zeichenfolge	Nein	–	Beschreibung des app-Inhalts, der freigegeben werden soll.
Gebietsschema	data-locale	String	Nein	en-US	Bevorzugte Sprache des Benutzers.
target	data-target	Zeichenfolge	Nein	selbst	Gibt an, ob der Link im selben Fenster, auf der neuen Registerkarte oder in einem neuen Fenster geöffnet wird.
buttonType	data-button-type	Zeichenfolge	Nein	primaryShareInMeeting	Gibt die Hintergrundfarbe der Schaltfläche an: primaryShareInMeeting oder secondaryShareInMeeting.
buttonSize	data-button-size	Zeichenfolge	Nein	–	Schaltflächengröße in Pixel.

Endbenutzererfahrung für Drittanbieter-Apps

Nachdem Sie "In Besprechung teilen" für Drittanbieter-Apps aktiviert haben, können Sie die Apps für die Besprechungsphase freigeben. Führen Sie für den Zugriff die folgenden Schritte aus:

Wenn die Besprechungserweiterung installiert ist:

1. Öffnen Sie die Web-App im Browser, und wählen Sie In Besprechung freigeben aus.

   

2. Wählen Sie Freigabe starten aus.

   

3. Die Web-App wird für die Besprechungsphase freigegeben, und alle Teilnehmer können gemeinsam interagieren und bearbeiten.

   

Wenn die Besprechungserweiterung nicht installiert ist:

1. Öffnen Sie die Web-App im Browser, und wählen Sie In Besprechung freigeben aus.

   

2. Um die App für die Besprechungserweiterung zu installieren, wählen Sie Hinzufügen aus.

   

3. Wählen Sie Freigabe starten aus.

   

4. Die Web-App wird für die Besprechungsphase freigegeben, und alle Teilnehmer können gemeinsam interagieren und bearbeiten.

   

Generieren eines Deep-Links zum Freigeben von Inhalten, die in Besprechungen bereitgestellt werden sollen

Sie können auch einen Deep-Link generieren, um die App zu teilen, um eine Besprechung zu starten oder zu starten. Wenn ein Deep Link in einer App von einem Benutzer ausgewählt wird, der Teil einer laufenden Besprechung ist, wird die App für die Phase freigegeben, und ein Popupfenster für berechtigungen wird angezeigt. Benutzer können den Teilnehmern Zugriff gewähren, um mit einer App zusammenzuarbeiten.

Wenn ein Benutzer nicht an einer Besprechung teilnimmt, wird er zum Teams-Kalender umgeleitet, wo er an einer Besprechung teilnehmen oder eine sofortige Besprechung (Jetzt besprechen) initiieren kann.

Sobald der Benutzer eine sofortige Besprechung initiiert (Jetzt besprechen), kann er Teilnehmer hinzufügen und mit der App interagieren.

Informationen zum Hinzufügen eines Deep-Links zum Freigeben von Inhalten in Besprechungen finden Sie unter Deep-Link zum Freigeben von Inhalten in Besprechungen.

Hinweis

Damit Ihre App die Überprüfung bestehen kann, verwenden Sie beim Erstellen eines Deep-Links von Ihrer Website, Web-App oder adaptiven Karte die Option In Besprechung teilen als Zeichenfolge oder Kopie.

Codebeispiel

Beispielname	Beschreibung	.NET	Node.js	Manifest
Besprechungsphasenansicht	Mit dieser App können Sie Ihre Apps für Teams-Besprechungen aktivieren und konfigurieren. Außerdem wird die Verwendung des Features "Teilen in Besprechungen" veranschaulicht.	View	View	Anzeigen

Siehe auch

• Apps für Teams-Besprechungen und -Anrufe
• Von Web-Apps für Teams freigeben
• Für Teams über persönliche App oder Registerkarte freigeben
• Erstellen von Deep-Links
• Adaptive Karten