Usar um complemento do Meet

Este guia fornece uma visão geral de como as pessoas começam e trabalham com um complemento do Google Meet.

Iniciar um complemento no painel "Atividades"

Em uma chamada do Google Meet, os usuários podem clicar no botão "Atividades". Isso vai abrir o painel "Atividades", que mostra uma lista de recursos integrados do Meet e todos os complementos instalados pelo usuário. Clicar em um ícone abre a visualização do painel lateral do complemento.

Palco principal e painel lateral do SDK de complementos do Meet.
Figura 1. Palco principal e painel lateral do SDK de complementos do Meet.

Colaborar com outros usuários

Para permitir que os usuários colaborem, o complemento precisa definir o CollaborationStartingState. Para mais informações, consulte Colaborar usando um complemento do Meet.

Depois de abrir uma visualização do painel lateral de complemento com o CollaborationStartingState definido, os usuários podem começar a trabalhar juntos clicando em Iniciar atividade.

Por exemplo, um complemento pode querer permitir que os usuários colaboram em um documento, mas o complemento não sabe qual documento. Nesse caso, o documento precisa estar selecionado na visualização do painel lateral. Depois de garantir que o documento possa ser compartilhado com outras pessoas, o complemento pode definir CollaborationStartingState com outros identificadores de documento necessários.

Iniciar uma atividade para que outras pessoas possam colaborar.
Figura 2. O botão de iniciar atividade.

Colabore na etapa principal

As atividades colaborativas podem ser feitas no painel lateral ou no palco principal. Se um mainStageUrl estiver listado no manifesto do complemento, clicar no botão Iniciar atividade abrirá automaticamente o complemento no estágio principal e iniciará a colaboração. Se nenhum mainStageUrl estiver listado no manifesto do complemento, clicar no botão Iniciar atividade apenas iniciará a colaboração.

Quando o estágio principal estiver aberto, um complemento poderá fechar o painel lateral chamando MeetMainStageClient.unloadSidePanel. Para estender o exemplo anterior, um painel lateral que escolhe um documento pode não ser mais relevante e pode ser fechado.

Para reabrir a visualização do painel lateral, o complemento pode chamar MeetMainStageClient.loadSidePanel. Por exemplo, um complemento que cria enquetes de usuários pode reabrir o painel lateral para mostrar as taxas de resposta às perguntas.

Iniciar um complemento pelo compartilhamento de tela

Os usuários podem iniciar complementos durante o compartilhamento de tela. Se um usuário compartilhar a tela de um site que tem um complemento, ele poderá promover o complemento para o usuário usando o método MeetAddonScreenshare.exposeToMeetWhenScreensharing. Isso mostra ao usuário um banner de notificação na chamada do Meet, solicitando que o usuário instale ou inicie o complemento. Para mais informações, consulte Promover um complemento para os usuários usando o compartilhamento de tela.

Como outras informações podem ser fornecidas ao estado inicial do complemento no site em que o usuário está compartilhando a tela, o complemento pode ignorar o painel lateral e iniciar a colaboração no estágio principal imediatamente após o lançamento. Se o complemento precisar realizar outras etapas, como alterar permissões em um documento para compartilhar, ele poderá ser iniciado no painel lateral e seguir o fluxo descrito em Colaborar com outros usuários.