Administra objetos de clientes

En esta página, se describe cómo administrar los objetos cliente que un complemento necesita para comunicarse con Google Meet.

Primero, el complemento debe establecer una sesión:

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

Reemplaza CLOUD_PROJECT_NUMBER por el número de proyecto de Google Cloud.

Desde la sesión, se pueden crear dos objetos de cliente:

Es importante recuperar el objeto de cliente correcto para el escenario principal o el panel lateral. Si se recupera el cliente incorrecto, el SDK de complementos de Google Meet arroja una excepción. Para verificar en qué iframe (escenario principal o panel lateral) se ejecuta el complemento, usa el método getFrameType().

En la siguiente muestra de código, se muestra cómo crear una instancia del objeto cliente de la etapa principal:

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

Reemplaza CLOUD_PROJECT_NUMBER por el número de proyecto de tu proyecto de Cloud.

Funciones compartidas

Algunas funciones están disponibles en MeetMainStageClient y en el objeto MeetSidePanelClient, mientras que otras son específicas de un cliente determinado.

Por ejemplo, estas son algunas de las funciones que están disponibles en ambos clientes:

  • El método getActivityStartingState() que obtiene información sobre el estado inicial del complemento cuando el participante acepta la invitación para unirse a la actividad.
  • El método getMeetingInfo() que obtiene detalles sobre la reunión en la que se ejecuta el complemento
  • El método setActivityStartingState() que establece el estado inicial del complemento cuando el participante acepta la invitación para unirse a la actividad
  • Para obtener una lista completa de las funciones de ambos clientes, consulta el objeto MeetAddonClient.

Funciones específicas para el cliente

Funciones disponibles solo en el objeto MeetMainStageClient:

  • El método notifySidePanel() envía un mensaje al panel lateral. Para recibir el mensaje, se suscribe a la devolución de llamada frameToFrameMessage en el panel lateral.

  • El método loadSidePanel() abre el iframe del panel lateral. La fuente del iframe se establece en la URL del panel lateral del archivo de manifiesto.

  • El método unloadSidePanel() cierra el iframe del panel lateral. El estado del complemento no se retiene en Meet cuando se llama al método. Depende del complemento conservar cualquier estado del complemento antes de que se llame a este método.

Funciones disponibles solo en el objeto MeetSidePanelClient: