Gerenciar objetos do cliente

Esta página descreve como gerenciar objetos de 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",
    });

Substitua CLOUD_PROJECT_NUMBER pelo número do projeto na nuvem do Google Cloud.

Na sessão, dois objetos de cliente podem ser criados:

É importante recuperar o objeto de cliente correto para o palco 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 (palco principal ou painel lateral) o complemento está em execução, use o getFrameType() método.

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

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

Substitua CLOUD_PROJECT_NUMBER pelo número do projeto do seu projeto na nuvem.

Recursos compartilhados

Alguns recursos estão disponíveis nos objetos MeetMainStageClient e MeetSidePanelClient, enquanto outros são específicos de um determinado cliente.

Por exemplo, alguns recursos disponíveis nos dois clientes incluem:

  • O getActivityStartingState() método que recebe informações sobre o estado inicial do complemento quando o participante aceita o convite para participar da atividade.
  • O getMeetingInfo() método que recebe detalhes sobre a reunião em que o complemento está em execução.
  • O setActivityStartingState() método que define o estado inicial do complemento quando o participante aceita o convite para participar da atividade.
  • Para uma lista abrangente de recursos nos dois clientes, consulte o MeetAddonClient objeto.

Recursos específicos do cliente

Recursos disponíveis apenas no MeetMainStageClient objeto:

  • O notifySidePanel() método envia uma mensagem para o painel lateral. A mensagem pode ser recebida por assinando o frameToFrameMessage callback no painel lateral.

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

  • O unloadSidePanel() método 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.

Recursos disponíveis apenas no MeetSidePanelClient objeto: