Créer des applications pour la phase de réunion Teams

Microsoft Teams améliore les expériences de réunion en fournissant des fonctionnalités qui facilitent la collaboration et la communication transparentes. La fonction de partage d’écran est un excellent exemple, qui permet aux utilisateurs de présenter l’intégralité de leur écran, des fenêtres spécifiques ou même des sessions de tableau blanc. Cette fonctionnalité est essentielle pour des présentations efficaces et un travail collaboratif, car elle garantit que tous les participants peuvent afficher et interagir avec le contenu partagé, ce qui rend les réunions virtuelles plus dynamiques et attrayantes.

En plus du partage d’écran, Microsoft Teams propose divers outils conçus pour rendre les interactions virtuelles plus productives. Ces outils répliquent la dynamique des réunions en personne, ce qui permet aux utilisateurs de collaborer efficacement, quel que soit leur emplacement physique. L’intégration de ces fonctionnalités dans Teams permet aux organisations de mener des réunions plus interactives et fructueuses, ce qui améliore le travail d’équipe et les résultats.

Le partage à la phase et le contenu de partage d’écran pour les réunions sont des fonctionnalités qui améliorent l’expérience de partage dans Teams. Partager à la phase permet aux utilisateurs de partager une application avec la phase de réunion à partir du panneau latéral de la réunion dans une réunion en cours. Le partage d’écran de contenu pour les réunions permet aux utilisateurs de partager du contenu à l’étape de réunion dans Teams à l’aide de l’architecture de partage d’écran.

Le tableau suivant répertorie les scénarios d’utilisation des fonctionnalités Partage d’écran et Partage pour mettre en scène :

Partager à l’étape

Partager à la phase permet aux utilisateurs de partager une application avec la phase de réunion à partir du panneau latéral de la réunion dans une réunion en cours. Ce partage est interactif et collaboratif par rapport au partage d’écran passif.

Pour appeler le partage à la phase, les utilisateurs peuvent sélectionner l’icône Partager sur phase en haut à droite du panneau côté réunion. L’icône Partager vers la phase est native du client Teams et sa sélection partage l’ensemble de l’application à la phase de réunion.

Manifeste d'application

Pour partager une application avec la phase de réunion, vous devez configurer le contexte et les autorisations de consentement spécifiques à la ressource (RSC) dans le manifeste de l’application :

1. Mettez à jour la context propriété dans le manifeste de l’application comme suit :

   "context": [
     "meetingSidePanel",
     "meetingStage"
   ]
   

2. Obtenez les autorisations RSC en configurant la authorization propriété , ainsi que les name et type dans le resourceSpecific champ comme suit :

   "authorization": {
     "permissions": {
       "resourceSpecific": [
         {
           "name": "MeetingStage.Write.Chat",
           "type": "Delegated"
         }
       ]
     }
   }
   

API avancées de partage à phase

Il existe de nombreux scénarios où le partage de l’ensemble de l’application à l’étape de réunion n’est pas aussi utile que le partage de parties spécifiques de l’application :

1. Pour une application de brainstorming ou de tableau blanc, un utilisateur peut souhaiter partager un tableau spécifique dans une réunion par rapport à l’ensemble de l’application avec tous les tableaux.

2. Pour une application médicale, un médecin peut souhaiter partager uniquement la radiographie à l’écran avec le patient, au lieu de partager l’ensemble de l’application avec tous les dossiers ou résultats des patients, etc.

3. Un utilisateur peut souhaiter partager du contenu à partir d’un seul fournisseur de contenu à la fois (par exemple, YouTube) plutôt que de partager un catalogue vidéo entier sur scène.

Pour aider les utilisateurs dans de tels scénarios, les API de la bibliothèque cliente JavaScript Microsoft Teams (TeamsJS) vous permettent d’appeler par programmation partage pour des parties spécifiques de l’application à partir d’un bouton dans le panneau latéral de la réunion.

Si vous utilisez un partage avancé pour préparer l’API, vous pouvez personnaliser le texte sur le bouton. Voici les instructions pour la personnalisation :

• Utilisez Partager et non Présenter ou Partage d’écran, si votre expérience offre un partage simple du contenu de l’application à la phase. Cela définit la bonne attente pour les utilisateurs, car Partager signifie systématiquement Partager pour mettre en scène des réunions Teams.
• Utilisez un texte plus spécifique pour fournir un contexte explicite du scénario. Par exemple, vous pouvez utiliser du texte comme Regarder ensemble ou Jouer ensemble si votre application propose des vidéos ou des jeux occasionnels.

Utilisez les API suivantes pour partager une partie spécifique de l’application :

const appContentUrl = "https://www.bing.com/";

microsoftTeams.meeting.shareAppContentToStage((err, result) => {
    if (result) {
        // handle success
    }
    if (err) {
        // handle error
    }
}, appContentUrl);

microsoftTeams.meeting.getAppContentStageSharingState((err, result) => {
    if (result.isAppSharing) {
        // Indicates if app is sharing content on the meeting stage.
    }
});

{
  "isAppSharing": true
}

microsoftTeams.meeting.getAppContentStageSharingCapabilities((err, result) => {
    if (result.doesAppHaveSharePermission) {
        // Indicates if the meeting participant has permission to share content to the meeting stage.
    }
});

{
   "doesAppHaveSharePermission":true
} 

Partager le contenu d’écran dans les réunions

Les utilisateurs peuvent afficher un écran de partage de contenu dans la phase de réunion dans Teams à l’aide de l’architecture de partage d’écran. Lorsqu’un utilisateur partage une application à la phase de réunion, l’application est affichée uniquement sur l’appareil du présentateur, puis l’écran est partagé ou mis en miroir pour tous les autres participants dans une nouvelle fenêtre. Une fois que le contenu de l’application est partagé dans une réunion, tous les participants peuvent afficher le contenu, mais seul le présentateur a la possibilité d’interagir avec le contenu, ce qui offre une expérience d’affichage multi-lecteur.

Le partage d’écran du contenu dans la phase de réunion simplifie le partage de contenu d’application pendant les réunions et offre une expérience d’affichage multi-joueur transparente. Explorons les cas d’usage de la fonctionnalité :

Les utilisateurs peuvent afficher le contenu de partage à l’étape de réunion dans les scénarios suivants :

• Partager l’application entière : lorsque vous partagez un onglet à la phase de réunion dans une réunion Teams, le contentUrl associé à l’onglet affiche une nouvelle fenêtre pour l’application et partage cette fenêtre avec tous les autres participants à la réunion. La page.frameContext propriété dans l’objet getContext est définie sur meetingStage pour signaler à l’application qu’elle est présentée sur une grande surface, ce qui permet à l’application de mettre à jour son contenu de manière appropriée.

  Remarque

  Les applications qui spécifient MeetingStage dans la page.frameContext propriété de l’objet getContext dans le manifeste et déclarent MeetingStage.Write.Chat des autorisations prennent en charge l’infrastructure collaborative Share to Stage. Le bouton Partager lance le protocole collaboratif existant au lieu du protocole de partage d’écran.

• Partager des parties spécifiques de votre application à la phase de réunion : spécifiez le protocole de partage approprié avec le appContentURL.

Le code suivant est un exemple de partage de contenu d’application vers l’affichage de la phase de réunion et de partage de contenu en mode de partage d’écran en affichage uniquement :

   // Share the content to meeting stage view.
    const shareSpecificAppContent = (partName) => {
        var appContentUrl = "";
        microsoftTeams.app.getContext().then((context) => {
            appContentUrl = partName == 'todo' ? `${window.location.origin}/todoView?meetingId=${context.meeting.id}` : partName == 'doing' ? `${window.location.origin}/doingView?meetingId=${context.meeting.id}` : `${window.location.origin}/doneView?meetingId=${context.meeting.id}`;
            microsoftTeams.meeting.shareAppContentToStage((err, result) => {
                if (result) {
                    // handle success
                    console.log(result);
                }

                if (err) {
                    // handle error
                    alert(JSON.stringify(err))
                }
            }, appContentUrl);
        });
    };

  // Share the content in view-only screen sharing mode.
      const shareSpecificAppContentScreenShare = (partName) => {
          var appContentUrl = "";
          microsoftTeams.app.getContext().then((context) => {
              appContentUrl = partName == 'todo' ? `${window.location.origin}/todoView?meetingId=${context.meeting.id}` : partName == 'doing' ? `${window.location.origin}/doingView?meetingId=${context.meeting.id}` : `${window.location.origin}/doneView?meetingId=${context.meeting.id}`;
              microsoftTeams.meeting.shareAppContentToStage((err, result) => {
                  if (result) {
                      // handle success
                      console.log(result);
                  }

                  if (err) {
                      // handle error
                      alert(JSON.stringify(err))
                  }
              }, appContentUrl,
                  // Optional shareOptions with sharingProtocol set to ScreenShare
                  {
                      sharingProtocol: microsoftTeams.meeting.SharingProtocol.ScreenShare
                  });
          });
      };

Pour plus d’informations sur les paramètres, consultez shareAppContentToStage.

Scénarios

Avantages

• Vous pouvez afficher du contenu coordonné à plusieurs participants sur une phase plus large, en obtenant plus d’attention et en s’intégrant plus étroitement au cycle de vie de la réunion.
• Le partage de base pour l’ensemble de l’application est disponible sans investissement supplémentaire.
• Les utilisateurs peuvent utiliser leurs outils favoris dans le contexte de leur communication continue, ce qui améliore les résultats des réunions.
• Le contenu est affiché inline dans la fenêtre de réunion.
• Un bouton de partage est disponible sur tous les panneaux latéraux de réunion pour les utilisateurs disposant du rôle organisateur ou présentateur.
• Les utilisateurs peuvent lancer le partage via un lien profond ou le bouton Partager dans la réunion.

Obtenir le contenu de l’application dans le panneau latéral de la réunion

L’API sharing.history.getContent vous permet de récupérer le contenu partagé dans une réunion et de l’afficher dans le panneau latéral de la réunion.

Au début d’une réunion, l’application, dans laquelle le contenu est partagé, ouvre automatiquement le panneau latéral de la réunion pour l’utilisateur qui a partagé le contenu. Vous pouvez appeler l’API sharing.history.getContent pour extraire une liste de contenu partagé et l’afficher dans le panneau latéral, ce qui la rend facilement accessible. Pour une réunion périodique à venir, où l’application est déjà ajoutée, les développeurs peuvent appeler l’API pour obtenir le contenu le plus récent à afficher dans le panneau latéral de l’application.

Le code suivant est un exemple pour extraire du contenu partagé dans le panneau latéral de la réunion :

// Define an async function
async function fetchContentDetails() {
    // Fetches a list of content details that was shared in the meeting
    const contentDetails = await microsoftTeams.sharing.history.getContent();

    // Above content details can be used to hydrate the meeting side panel 
    // to share to meeting stage

}

Paramètres de charge utile de réponse

Le tableau suivant inclut les paramètres de charge utile de réponse :

Codes de réponse

Le tableau suivant présente les codes de réponse :

Pour plus d’informations, consultez sharing.history.getContent.

Créer une application de signature de document en réunion

Vous pouvez créer une application en réunion pour permettre aux participants à la réunion de connecter des documents en temps réel. Il facilite l’examen et la signature de documents en une seule session. Les participants peuvent signer les documents à l’aide de leur identité de locataire actuelle.

Vous pouvez utiliser une application de signature en réunion pour :

• Ajouter des documents à réviser pendant une réunion.
• Partagez des documents à réviser à main étape.
• Signer des documents à l’aide de l’identité du signataire.

Les participants peuvent consulter et signer des documents, tels que des contrats d’achat et des bons de commande.

Les rôles de participants suivants peuvent être impliqués pendant la réunion :

• Créateur de documents : ce rôle peut ajouter ses propres documents à réviser et à signer.
• Signataire : ce rôle peut signer des documents révisés.
• Lecteur : ce rôle peut afficher les documents ajoutés à la réunion.

Exemple de code

Guide pas à pas

Suivez le guide pas à pas pour créer une application de signature de document en réunion.

Voir aussi

• Applications pour les réunions Teams
• Activer l’authentification à l’aide d’un fournisseur OAuth tiers
• Consentement spécifique à la ressource pour les autorisations déléguées
• Créer des liens plus étroits
• API d’application de réunion
• Scènes personnalisées du mode ensemble
• FAQ sur le Kit de développement logiciel (SDK) de Live Share