Gérer les objets client

Cette page explique comment gérer les objets client 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 votre projet Google Cloud.

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

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

• Le MeetSidePanelClient d'un module complémentaire s'exécutant 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 quel iframe (zone principale ou panneau latéral) le module complémentaire s'exécute, utilisez la méthode getFrameType().

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 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 méthode getActivityStartingState() qui obtient des informations sur l'état initial du module complémentaire lorsque le participant accepte l'invitation à rejoindre l'activité.
• La méthode getMeetingInfo() permet d'obtenir des informations sur la réunion dans laquelle le module complémentaire est exécuté.
• La méthode setActivityStartingState() 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'objet MeetAddonClient.

Fonctionnalités spécifiques aux clients

Fonctionnalités disponibles uniquement dans l'objet MeetMainStageClient :

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

• La méthode loadSidePanel() 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 méthode unloadSidePanel() 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 incombe au module complémentaire de conserver tout état de module complémentaire avant l'appel de cette méthode.

Fonctionnalités disponibles uniquement dans l'objet MeetSidePanelClient :

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