In Besprechung teilen

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. Damit die Besprechungsteilnehmer mit einer Web-App oder einem Dokument eines Drittanbieters interagieren können, muss die 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.

Wenn Sie die Schaltfläche In Besprechung teilen auswählen, wird ein Deep-Link zur Besprechungsphase gestartet. Im Folgenden finden Sie das Deep Link-Format:

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

Weitere Informationen finden Sie unter Generieren eines Deep-Links zum Freigeben von Inhalten für die Staging in Besprechungen.

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 des Typs teams-share-in-meeting-button zu suchen und dynamisch Schaltflächen in Besprechungen 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.

Um einen Deep-Link zum Freigeben von Inhalten auf der Bühne hinzuzufügen, benötigen Sie einen App-Kontext. Der App-Kontext ermöglicht es dem Teams-Client, das App-Manifest abzurufen und zu überprüfen, ob die Freigabe auf der Bühne möglich ist. Es folgt ein Beispiel für einen App-Kontext:

{ "appSharingUrl" : "https://teams.microsoft.com/extensibility-apps/meetingapis/view", "appId": "9ec80a73-1d41-4bcb-8190-4b9eA9e29fbb" , "useMeetNow": false }

Die Abfrageparameter für den App-Kontext sind:

• appID: Dies ist die ID, die aus dem App-Manifest abgerufen werden kann.
• appSharingUrl: Die URL, die auf der Phase freigegeben werden muss, sollte eine gültige Domäne sein, die im App-Manifest definiert ist. Wenn die URL keine gültige Domäne ist, wird ein Fehlerdialogfeld angezeigt, in dem dem Benutzer eine Beschreibung des Fehlers angezeigt wird.
• useMeetNow: Dies schließt einen booleschen Parameter ein, der entweder true oder false sein kann.

  • True: Wenn der useMeetNow Wert true ist und keine laufende Besprechung vorhanden ist, wird eine neue Besprechung Jetzt besprechen initiiert. Wenn es eine laufende Besprechung gibt, wird dieser Wert ignoriert.

  • False: Der Standardwert von useMeetNow ist false. Dies bedeutet, dass ein Kalender-Popup angezeigt wird, wenn ein Deep Link für die Bühne freigegeben wird und keine laufende Besprechung vorhanden ist. Sie können jedoch während einer Besprechung direkt freigeben.

Stellen Sie sicher, dass alle Abfrageparameter ordnungsgemäß URI-codiert sind und der App-Kontext zweimal in der endgültigen URL codiert werden muss. Es folgt ein Beispiel:

const appContext= JSON.stringify({ 
  "appSharingUrl" : "https://teams.microsoft.com/extensibility-apps/meetingapis/view",
  "appId": "9cc80a93-1d41-4bcb-8170-4b9ec9e29fbb",
  "useMeetNow": false
});
const encodedContext = encodeURIComponent(appContext).replace(/'/g,"%27").replace(/"/g,"%22");
const encodedAppContext = encodeURIComponent(encodedContext).replace(/'/g,"%27").replace(/"/g,"%22");

Ein Deep Link kann entweder über das Teams-Web oder über den Teams-Desktop oder mobilen Client gestartet werden.

• Teams-Web: Verwenden Sie das folgende Format, um einen Deep-Link aus dem Teams-Web zu starten, um Inhalte auf der Bühne zu teilen:

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

  Beispiel: https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

  Deep-Link	Format	Beispiel
  Um die App freizugeben und den Teams-Kalender zu öffnen, wenn useMeeetNowfalse ist, standardwert.	https://teams.microsoft.com/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}}&lm=deeplink%22&appContext={encoded app context}	https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Afalse%257D
  Um die App zu teilen und eine sofortige Besprechung zu initiieren, wenn useMeeetNowtrue ist.	https://teams.microsoft.com/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}}&lm=deeplink%22&appContext={encoded app context}	https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

• Teams-Desktop oder mobiler Client: Verwenden Sie das folgende Format, um einen Deep-Link über den Teams-Desktop oder mobilen Client zu starten, um Inhalte auf der Bühne zu teilen:

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

  Beispiel: msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

  Deep-Link	Format	Beispiel
  Um die App freizugeben und den Teams-Kalender zu öffnen, wenn useMeeetNowfalse ist, standardwert.	msteams:/l/meeting-share? deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink%22&appContext={encoded app context}	msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Afalse%257D
  Um die App zu teilen und eine sofortige Besprechung zu initiieren, wenn useMeeetNowtrue ist.	msteams:/l/meeting-share? deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink%22&appContext={encoded app context}	msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

Die Abfrageparameter sind:

• deepLinkId: Jeder Bezeichner, der für die Telemetriekorrelation verwendet wird.
• fqdn: fqdn ist ein optionaler Parameter, der verwendet werden kann, um zu einer geeigneten Umgebung einer Besprechung zu wechseln, um eine App auf der Bühne zu teilen. Es unterstützt Szenarien, in denen eine bestimmte App-Freigabe in einer bestimmten Umgebung erfolgt. Der Standardwert von fqdn ist unternehmens-URL, und mögliche Werte sind Teams.live.com für Teams for Life, teams.microsoft.comoder teams.microsoft.us.

Um die gesamte App für die Phase freizugeben, müssen Sie im App-Manifest konfigurieren meetingStage und meetingSidePanel als Rahmenkontexte finden Sie unter App-Manifest. Andernfalls können Besprechungsteilnehmer den Inhalt auf der Bühne möglicherweise nicht sehen.

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