Acessar o objeto do cliente

Prévia para desenvolvedores:disponível como parte do Programa de prévia para desenvolvedores do Google Workspace, que concede acesso antecipado a determinados recursos.

Esta página descreve como conseguir o objeto cliente que um complemento precisa para se comunicar com o Google Meet.

Primeiro, o complemento precisa estabelecer uma sessão:

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

Na sessão, é possível criar dois objetos de cliente:

• O MeetMainStageClient de um complemento em execução no estágio principal, que pode ser recuperado usando await session.createMainStageClient().

• O MeetSidePanelClient de um complemento em execução no painel secundário, recuperável usando await session.createSidePanelClient().

É importante recuperar o objeto de cliente correto para o cenário principal ou o painel lateral. Se o cliente errado for recuperado, o SDK de complementos do Google Meet vai gerar uma exceção. Para verificar em qual iframe (cenário principal ou painel lateral) o complemento está sendo executado, use o método MeetAddon.getFrameType.

O exemplo de código a seguir mostra como instanciar o objeto de cliente do estágio principal:

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

Funcionalidade compartilhada

Algumas funcionalidades estão disponíveis no MeetMainStageClient e no MeetSidePanelClient, enquanto outras são específicas de um determinado cliente.

Por exemplo, algumas funcionalidades disponíveis nos dois clientes incluem:

• O método MeetAddonClient.getCollaborationStartingState, que recebe informações sobre o estado inicial do complemento quando o participante aceita o convite para colaborar.
• O método MeetAddonClient.getMeetingInfo que recebe detalhes sobre a reunião em que o complemento está sendo executado.
• O método MeetAddonClient.getMeetPlatformInfo que recebe detalhes sobre a plataforma da reunião em que o complemento está sendo executado.
• O MeetAddonClient.setCollaborationStartingState, que define o estado inicial do complemento quando o participante aceita o convite para colaborar.
• Para uma lista abrangente de funcionalidades em ambos os clientes, consulte o objeto MeetAddonClient.

Funcionalidade específica do cliente

Funcionalidade disponível apenas no MeetMainStageClient:

• O MeetMainStageClient.notifySidePanel envia uma mensagem ao painel lateral. A mensagem pode ser recebida ao se inscrever no callback frameToFrameMessage (link em inglês) no painel lateral.

• O método MeetMainStageClient.loadSidePanel abre o iframe do painel lateral. A origem do iframe é definida como o URL do painel lateral do arquivo de manifesto.

• O método MeetMainStageClient.unloadSidePanel fecha o iframe do painel lateral. O estado do complemento não é mantido no Meet quando o método é chamado. Cabe ao complemento manter qualquer estado antes que esse método seja chamado.

Funcionalidade disponível apenas no MeetSidePanelClient:

• O MeetSidePanelClient.notifyMainStage envia uma mensagem para o mainStage. A mensagem pode ser recebida ao se inscrever no callback frameToFrameMessage (link em inglês) no cenário principal.