Gérer les objets client

Cette page explique comment gérer les objets clients dont un module complémentaire a besoin pour communiquer avec Google Meet.

Tout d'abord, le module complémentaire doit établir une session :

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
    });

Remplacez CLOUD_PROJECT_NUMBER par le numéro de projet de votre projet Google Cloud.

Deux objets clients peuvent être créés à partir de la session :

• Le MeetMainStageClient pour un module complémentaire exécuté sur la scène principale, récupérable à l'aide de await session.createMainStageClient().

• Le MeetSidePanelClient pour un module complémentaire exécuté dans le panneau latéral, récupérable à l'aide de await session.createSidePanelClient().

Il est important de récupérer l'objet client approprié pour la scène principale ou le panneau latéral. Si le mauvais client est récupéré, le SDK des modules complémentaires Google Meet génère une exception. Pour vérifier dans quelle iframe (scène principale ou panneau latéral) le module complémentaire est exécuté, utilisez la getFrameType() méthode.

L'exemple de code suivant montre comment instancier l'objet client de la scène principale :

  const session = await window.meet.addon.createAddonSession({
      cloudProjectNumber: "CLOUD_PROJECT_NUMBER"
    });
  const mainStageClient = await session.createMainStageClient();

Remplacez CLOUD_PROJECT_NUMBER par le numéro de projet de votre projet Cloud.

Fonctionnalités partagées

Certaines fonctionnalités sont disponibles dans les objets MeetMainStageClient et MeetSidePanelClient, tandis que d'autres sont spécifiques à un client donné.

Par exemple, voici quelques fonctionnalités disponibles dans les deux clients :

• La getActivityStartingState() méthode qui obtient des informations sur l'état initial du module complémentaire lorsque le participant accepte l'invitation à rejoindre l'activité.
• La getMeetingInfo() méthode qui obtient des informations sur la réunion dans laquelle le module complémentaire est exécuté.
• La setActivityStartingState() méthode qui définit l'état initial du module complémentaire lorsque le participant accepte l'invitation à rejoindre l'activité.
• Pour obtenir la liste complète des fonctionnalités des deux clients, consultez l' MeetAddonClient objet.

Fonctionnalités spécifiques au client

Fonctionnalités disponibles uniquement dans l' MeetMainStageClient objet :

• La notifySidePanel() méthode envoie un message au panneau latéral. Le message peut être reçu en s'abonnant au frameToFrameMessage rappel dans le panneau latéral.

• La loadSidePanel() méthode ouvre l'iframe du panneau latéral. La source de l'iframe est définie sur l'URL du panneau latéral à partir du fichier manifeste.

• La unloadSidePanel() méthode ferme l'iframe du panneau latéral. L'état du module complémentaire n'est pas conservé dans Meet lorsque la méthode est appelée. Il appartient au module complémentaire de conserver l'état du module complémentaire avant l'appel de cette méthode.

Fonctionnalités disponibles uniquement dans l' MeetSidePanelClient objet :

• La notifyMainStage() méthode envoie un message à la scène principale. Le message peut être reçu en s'abonnant à la frameToFrameMessage propriété de rappel dans la scène principale.